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CONSIDERABLY ENHANCED DO * If I ^"n! S ToTBn, 2 F F S R 1 

KTiSM H Y ASES ^.FACTOR OE ^ 
WHILE OK UNTIL MAY BE USEU ON ALL 

NEW CONTROL STATEMENTS LEAVE AND ITERATE PERMIT EXIT OR STEPPING OF 
CONTROLLED DO-LOOPS. 

SUBSTR NOW PADS WITH BLANKS, TRANS IS I 

CLAUSES MAY BE CONTINUED FROM ONE LINE TO ANOTHER USING THE NEW 
CONTINUATION CHAR ACT ER "»"• 

EXTFNDED AND REDEFINED ADDRESS INSTRUCTION ALLOWS A SINGLE COMMAND 
TO BE SENT TO AN ENVIRONMENT. 'CMS* REINSTATED AS NAME FOR HOST. 

LOGICAL EXPRESSIONS MUST RESULT IN *0* OR ’l'. 

ENHANCEMENTS TO TRACING: 

INVALID TRACE OPTIONS NOW GIVE A SYNTAX ERROR. 

CALL TRACE-BACK GIVEN IF ERROR OCCURS INSIDE A SUBROUTINE ETC. 

THE DOUBLE-QUOTE MAY BE USED AS AN ALTERNATIVE TO THE SINGLE-QUOTE 
TO DELIMIT STRINGS. DOUBLE-QUOTE IS THEREFORE NOW A SPECIAL 
CHARACTER. EG: SAY "ISN'T THIS NICE?" 

VARIABLE NAMES (OTHER THAN MAY NOT BEGIN WITH A PERIOD. 

VALID CHARACTERS FOR SYMBOLS ARE A-Z, A-Z, 0-9, a?*££. ?, UNDERSCORE 

NEW NOP (NO-OPERATION) COMMAND FOR DUMMY THEN/ELSE/WHEN STATEMENTS. 

RC AFTER 'SIGNAL ON SYNTAX* DOES NOT HAVE 20000 ADDED. 

MANY LENGTH AND FUNCTION RESTRICTIONS SOMEWHAT RELAXED. 

(EG, CLAUSES MAY NOW.BE UP TO 500 CHARACTERS LONG). 

A CLAUSE OF THE FORM "SYMBOl=EXPRESSION" IS NOW ALWAYS TAKEN TO BE 
AN ASSIGNMENT. THIS MAKES KEYWORDS FAR LESS RESERVED. 

THEN NOW ONLY ACTS AS A TERMINATOR FOR I F OR WHEN CLAUSES. 

ONLINE HELP AND TUTORIAL HAS ADDED FUNCTION, ALSO A SUB-INDEX FOR 
EACH OF I OX, FSX, REXFNS ETC. FSX HAS IMPROVED LlGHTPEN ABILITY. 
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1. IMI3.QQULIIQNI 


l.l tmti is rex? 

,rp AS a .. Di RECt 

REX IS A COMMAND PROGRAMMING LANGUAGE. IT CAN BE ? L ANG UAGt;S ’ AND 
REPLACEMENT FOR OR ALTERNATIVE TO THE CMS EXEC AND EXEC L 
AS A "MACRO PROCESSOR” FOR EDITORS ETC. LANGUAGE: IT 

IT HAS SEVERAL ADVANTAGES OVER THE STANDARD CMS EXt ^ lT is VERy 
DOES NOT TOKENISS DATA; IT IS MORE FLEXIBLE AND GENERAL, 0 p ANY KIND, 
MUCH EASIER TO LEARN AND USE. IF THE EXEC INVOLVES Lt 

structures AND 
SUPERIOR CONTROL s EDITOR 

DRE SUITABLL 


EASIER TO LE 

THEN REX IS SIGNIFICANTLY FA5TFK. 

COMPARED WITH EXEC 2, REX HAS 
EXPRESSION EVALUATION, AND IN MANY WAYS 
MACROS AND COMMAND PARSING. 

THE LANGUAGE ITSELF IS PL/I LIKE, AND i 
IN ITS CMS IMPLEMENTATION IT IS EASILY IN ;> l ali-cu gR THE 

EXTENSION", EITHER UNDER ITS OWN NAME OR MORE USEFULL ONE OF 

•EXEC*. IN THIS MODE YOU MAY WRITE FILLS W1TH fiLtTY t , 0R REX> 

THREE LANGUAGES: EXEC (STANDARD CMS), EXEC 2 1T EP f T 0 N TO THE 
THE REX INTERFACE WILL EXAMINE THE FILE AND PASS ‘ gNT 1T W1LL 
APPROPRIATE INTERPRETER. (If THE FILE BEGINS WITH A REX C ^ W1TH 

BE INTERPRETED BY REX, ETC.). JhlS MEANS THAT REX »V-L HAV1 NG 

BOTH EXEC AND EXEC 2 AND YOU HAY GRADUALLY CONVERT TO REX 

to change any of your existing execs. (stE the £y tntfrpreter from 

INTER FAC E S * FOR DETAILS). YOU MAY, TOO? INVOKE THE REX INT Au'-TniN' 

IJrOGRAM WITH THi data TO BE INTERPRETED HELD IN STORAGE, SO AVuIDIN. 
FILE SYSTEM OVERHEADS. 


cT cm INDEPENDENT. 
LARGELY SYSTE c 4 "NUCLEUS 
installed 


1.2 WHY 


THE CMS EXEC LANGUAGE (WHICH HAS SINCE BEEN EXTENDED AND IMPROVED 
UPON BY EXEC 2) IS BASED UN THE COMMON MACRO LANGUAGE PRINCIPLE ThAT 
VARIABLES AND CONTROLS SHOULD BE D1STINGU1SHED (BY "A") AND LITERALS 
SHOULD EXIST IN^ PL AIN^ TEXT • ^y ^ STRIl>(GS 0F COMMANDS, WITH VERY LITTLE 
LOGIC IN BETWEEN, THIS WAS A FAIR AND SENSIBLE CHOICE: HOWEVER A QUICK 
SCAN THROUGH THE EXECS OF AlMOST ANY MODERN USER QUICKLY SHOWS ThAT THE 
MAJORITY OF WORDS IN USE ARE SYMBOLIC (THAT IS, THEY BEGIN WITH "<*">• 
THIS OBSERVATION MUST CAST SOME DOUBT ON THE VALIDITY OF USING THIS 

SYNT A X FURTHER ARGUMENT IS THE INCREASING USE OF "COMPLICATED" STRINGS IN 
FXFCS: FOR EXAMPLE EMBEDDED BLANKS ARE HEAVILY USED IN EDITOR MACROS; 
FULL SCREEN DISPLAYS; AND SO ON. EXEC 2 HANDLES THESE ONLY FAIRLY WELL, 
WHEREAS EXEC CANNOT MANIPULATE THEM AT ALL: THE USER IS REDUCED TO 
UNREADABLE MANIPULATIONS OF THE UNDERSCORE CHARACTER OR OTHER 
MACHINATIONS TO ACHIEVE THE DESIRED RESULT. 

THERE IS PERHAPS AT LEAST SOME JUSTIFICATION IN INVESTIGATING AN 
ALTERNATIVE MACRO COMMAND LANGUAGE WHICH USES THE * MORE CONVENTIONAL* 
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notation used by the higher level, programming LANGUAGES SUCH as pl/i; 
pi /s; PASCAL; and so on. 

experience suggests that a language with this TYPE OF syntax will be 

"iCTFR TO LEARN AND USE THAN THAT WHICH MORE RESEMBLES a 'MaCRO 
fANCUAGE 1 • EL/I USERS IN PARTICULAR FIND REX ESPECIALLY USEFUL, AND 
MANY PEOPLE WHO BEFORE WOULD NOT LEARN A COMMAND LANGUAGE NOW USE REX. 

THF USE OF THIS TYPE OF NOTATION WILL NATURALLY CAUSE USERS TO DRAW 
rnMPAR1SONS WITH THE NORMAL PROGRAMMING LANGUAGES. THIS INEVITABLY WILL 
TO EXPECT A CORRESPONDING IMPROVEMtNT IN THE FACILITIES 
AVAILABLE IN U COMMAND LANGUAGE: THIS IN TURN WOULD SEEM TO I MP J Y THAT 
thf INTERPRETER MIGHT BE LARGER AND PROBABLY SLOWER THAN EITHER £XEC OR 
? cr7f (WITHIN REASON) IS NOT OFTEN A PRObLtM ON MODERN VIRTUAL 
MACHINES HOWEVER A SEVERE PERFORMANCE PENALTY WOULD BE UNACCEPTABLE IN 
SOME ENVIRONMENTS. SOME EFFORT HAS BEEN MADE TO tNSURE GOOD 

PERF SuRING E ’lMPLEMENTATION IT HAS BEEN FOUND THAT REX IS OF SIMILAR SIZE 
TH THF EXISTING INTERPRETERS (CURRENTLY ABOUT 1600. BYTLSt 10% OF WHICH 

; Ire thI erIoJ iessAGES). the current version is normally somewhat 
slower thaSexec 2; but usually very much faster than exec. 

WHAT THEN ARE THE MAJOR DESIRABLE FEATURES FOR A COMMAND MACRO 
LANGUAGE? MY CHOICE INCLUDED: 

1) STRUCTURED FLOW CONTROL STATEMENTS, SOME EQUIVALENT OF 
If-then-else, DO (UNTIL/WHILc)-END, seleci-when-end 
being the most important. 

2) FREE FORMAT: NOT LINE-BY-LINE 

3) SOME AUTOMATIC CASE TRANSLATION AS REQUIRED bY THE HOST, AND NO 
UPPER CASE REQUIREMENTS FOR MACRO KEYWORDS ETC. 

4) LITERAL SHORTHAND: UNKNOWN "TOKENS" ASSUMED TO BE ENCLOSED 
IN QUOTES. 

5) 'COMPLEX* EXPRESSIONS (I.E. PARENTHESES, MULTIPLE OPERATORS) 

6) IN LINE 'FUNCTION* CALLS TO OTHER EXECS OR MODULES 

7) NO REQUIREMENT FOR SELF-MODIFYING EXECS 

8) "PEER" COMMUNICATION BETWEEN EXECS AND PROGRAMS 

THE NEXT SECTION DISCUSSES THESE TOPICS IN MORE DETAIL, HOWEVER THE 
BUSY (OR IMPATIENT) READER MAY PREFER TO SKIP TO THE LANGUAGE DEFINITION 
IN SECTION 3. 


0 

0 

n 


r 

r 
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2. IHE LMGLJAGE. FEATURES 


c nEFlNlTIQNs q f •- 

THE FOLLOWING ITtMS ARE NOT INTENDED TO BE RIGOR° U ^ , T LAN GUage 
THE LANGUAGE FEATURES; AND SOME IMPLICIT ASSUMPTIONS *80 aTH ER GENERai 
SYNTAX AND THE HOST SYSTEM WILL BE APPARENT. THEY *R E fH CHOICE. 
DESCRIPTIONS OF THE SYNTAX AND THE DECISIONS LEADING TO EA 


2-1 LmiklURlD FLOW C ONTR OL ilAIEMEMIi 


THE NEED FOR STRUCTURED 
PROGRAMMERS. THE THREE MAIN 
THE IF-THEN-ELSE; DO • 

SELECT-WHEN-END. (THE USE OF 
ANY OF THE POSSIBLY SUPER 
LITERATURE IS PURELY FORCi 
IMPLEMENTED FOR EXEC BY USI 
DO-UNTIL; BUT NEITHER HAS AN 
EVIDENTLY ALL THESE FEATURES 
LANGUAGE, EVEN IF IN A SIMPLI 


FLOW CONTROL IS ACCEPTE qnTROL arp 
CLASSES OF STRUCTURED FLOW CON . L ARE 

( ITERATI0N/WH1LE/UNTIL)-END, and 

IBM (PL/I) CONSTRUCTIONS ^ ATHE * 

IOR ALTERNATIVES DESCRIBED IN THE 
0NS1STENCY.) IF-THEN-ELSE HAS BEEN 
NG MODULES; EXEC 2 HAS DO-WHIlE AND 
1 FORM OF SELECT (OR CASE) STRUCTURE. 
ARE HIGHLY DESIRABLE FDR ANY MODERN 
IED FORM. 


2.2 E.BEE FOR.MAI: MSI LIN E-BY-LIN E 


A FREE FORMAT STATEMENT IS POSSIBLY MURE GENERAL THAN FIXED 
(LINE-BY-LINE) FORMAT. THE LATTER OPTION IMPLIES A RECORD ORIENTED 
FILE SYSTEM, WHEREAS THE FORMER IS APPLICABLE BOTH TO RECORD AND 
CHARACTER STREAM FILES OR INPUT DEVICES. BY THE SAME TOKEN, A FREE 
FORMAT STRUCTURE WOULD IN GENERAL PERMIT BETTER SELF-DOCUMENTATION 
OF EXECS, SINCE COMMENTS MAY OCCUR ALMOST ANYWHERE IN THE INPUT 
STREAM. 

ALTHOUGH THE LANGUAGE IS BY NATURE AND SYNTAX A STREAM 
LANGUAGE, MOST IBM USERS WILL TEND TO USE A LINE-BY-LlNE FORMAT, 
WITH ONLY A FEW MULTI-STATEMENT LINES. THEREFORE REX TERMINATES 
EACH LINE (EXCEPT WHEN WITHIN A STRING OR COMMENT, OR WHEN 
INHIBITED BY THE CONTINUATION CHARACTER ”,’>) WITH AN IMPLICIT 
CLAUSE DELIMITER AS A SERVICE TO THE USER. SINCE REX Is AWARE OF 
LINE ENDS IT CAN INDICATE THE LINE NUMBER IN ERROR MESSAGES 

THE OBVIOUS CLAUSE DELIMITER TO USE WAS WITH /* */ FOR 

COMMENTS. * ** ' 
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2..3. CASE IMNSLAUOM 


THE OPERATING SYSTEM UNDERLYING THE REX INTERPk £t&r 

HANDS BE PASSED IN UPPER CASE. IN THE CMS/cJ ^ 

S HOWEVER NO SIMPLE RULE FOR .f, &°?HlS 

ION SHOULD TAKE PLACE: THE ONUS IS UNF0RTu NAT p^ N qN TH £ 


THERE IS HOWEVER NO : ; ^ SIMPLER 
TRANSLATII ' " ~ " 

REX ATTEMPTS TO MAKE THIS AS EASY AS POSSIBLE By TRamci atING 
all SYMBOLS (AS OPPOSED TO STRINGS) TO E * SE °URI Ng s ^,JnG* 

THIS HAS TWO MAIN EFFECTS: A) NO REX ^co^aL ^ EtD BE TY p ED IN 
UPPER CASE: ANY MIXTURE Oh UPPER AND LOWER CASE IS VALID; A nD B> 
MOST SYMBOLIC DATA (SEE NEXT SECTION) PASSED TO THE HOST will BE 
AUTOMATICALLY TRANSLATED AND THEREFORE ALSO May BE En T er£0 IN 
MULTI-CASE. MULTI-CASE PROGRAMS ARE OF COURSE MORE READABLE AND 
LESS PRONE TO HaVE ERRORS AND BUGS, SINCE Wt ALL ARE TrainED IN 
READING LOWER CASE CHARACTERS AS STANDARD. 

NOTE THAT DATA IN A STRING OR VARIABLE WILL NEVER 0E alTE rED 
WITHOUT THE EXPRESS INTENTION OF THE USER. 


2.4 LITERAL SHORTHAND A fLi-AiHS QP££.AJIiB. 

A CONVENIENT CONVENTION FOR A COMMAND LANGUAGE IS THAT OF 
•LITERAL SHORTHAND*. MY DEFINITION OF THIS IS: IF A SYMBOL IS 

UNKNOWN (I.E. NOT A VARIABLE, REX KEYWORD, OR FUNCTION CALL) ThEN 
IT IS ASSUMED TO REPRESENT A L1TF.RAL STRING CONSISTING OF THE 
CHARACTERS OF THE SYMBOL (TRANSLATED TO UPPER CASE). 

A FURTHER CONVENIENCE IS THE CONCEPT OF THE 'BLANK* OPERATOR. 
THIS MAY BE DEFINED VERBALLY THUS: IF TWO EXPRESSIONS (IE SYMBOLS, 
LITERALS, ETC.) ARE SEPARATED BY ONE OR MORE BLANKS MD NO OTHER 
OP E RA TOR THEN THE OPERATION OF 'CONCATENATE WITH A BLANK IN 
BETWEEN* WILL BE PERFORMED. 

THE EFFECT OF THESE TWO CONVENTIONS ALLOWS A SYNTAX THAT 
COMBINES THE ADVANTAGES OF BOTH EXEC/MaCRO LANGUAGES AND THE PL/I 
LIKE MODEL. CONSIDER THE FOLLOWING EXCERPT FROM A REX EXEC (ASSUME 
THAT FN, FT, FM ARE SYMBOLS REPRESENTING VARIABLES PREVIOUSLY SET 
UP BY ASSIGNMENTS ETC.): 


STATE FN FT FM 
IF RC=C THEN ERASE FN FT FM 


HICH IS MORE READABLE THAN THE EQUIVALENT 'STRICT PL/I*- FORM: 

'!IFM; 


•STATE *i |FN| |* *.|| FT | | • ■ | | FM ; 

IF RC=C THEN 'ERASE ' | | FN I I ' ' | | F T | [ * 


OR THE EXEC LANGUAGE FORM: 


STATE &FN 4FT &FM 

& IF &RETCODE = 0 ERASE 4FN &FT &FM 
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(A STATEMENT WHICH IS AN EXPRESSION ON ITS OWN IS PASSED 10 1H6 

HOST SYSTEM AS A COMMAND.) 


2*2 ♦COMPLEX ! EXPRESSIONS 

COMPOUND CHARACTER AND ARITHMETIC EXPRESSIONS ARE BE™& USED 
MORE AND MORE IN CURRENT EXECS: THEY DO OF COURSE HAVE TO BE SPREAD 
OVER SEVERAL LINES. (UP TO TEN LINES FOR ONE LOGICAL MANIPULATION 
IS NOT UNKNOWN ). REX THEREFORE PERMITS ‘COMPLEX' EXPRESSIONS. 

THERE ARE THREE POSSIBLE IMPLEMENTATIONS OF COMPOUND 

A) SIMPLE LEFT -> RIGHT (OR A PL RIGHT -> LEFT) SCANNING; 

B) REVERSE POLISH NOTATION (E.G. FORTH); 

C) FULL ALGEBRAIC, WITH PARENTHESES AND OPERATOR 
PRIORITIES. r . r 

OPTION 8) IS PROBABLY UNACCEPTABLE TO THE IBM USER, AND IS ALSO 
SOMEWHAT OUTDATED AS A SOLUTION. OPTION A) IS A CONSIDERABLE 
IMPROVEMENT ON NO COMPOUND EXPRESSIONS AT ALL, BUT IS NOT IDEAL - 
ESPECIALLY AS LOGICAL OPERATIONS SHOULD BE TREATED AS NORMAL 
OPERATORS, RATHER THAN SPECIAL CASES. 

OPTION C) IS OF COURSE THE BEST, AND IS NOT SIGNIFICANTLY MORt 
COMPLICATED TO IMPLEMENT THAN A). THE ALGORITHMS AND TECHNIQUES 
ARE WELL UNDERSTOOD, AND AN EXEC INTERPRETER NECESSARILY INCLUDES 
STORAGE MANAGEMENT ROUTINES WHICH NORMALLY ARE ABLE TO HANDLE 
STACK(S) . 

I CONSIDER THE MINIMUM SET OF PRIMITIVE DYADIC OPERATORS TO 
INCLUDE: + - * / || AND ' * AS DEFINED ABOVE, TOGETHER WITH THE 
LOGICAL OPERATORS = -.= > < >= <= & i £.&. IMPORTANT MONADIC 
OPERATORS ARE: + (PREFIX NOT, MINUS , AND +) . 

"(" AND ")" HAVE SPECIAL RULES AFFECTING THEIR USE, SINCE IN 
ADDITION TO FORCING PRIORITIES WITHIN EXPRESSION EVALUATION, THEY 
ARE ALSO USED TOR THE INVOCATION UF FUNCTIONS. THEREFORE BLANKS 
IMMEDIATELY OUTSIDE THE PARENTHESES ARE NOT IGNORED, AND SU THE ' • 
OPERATOR MAY ACT DIRECTLY ON A BRACKETED SUB-EXPRESSION. 


2-2 Hi LINE 1 FUNCTION-' QALLQ IQ QIHEK QXQQQ OR MODULE S 

THE ABILITY TO DEFINE IN-EXPRESSION FUNCTIONS GREATLY INCREASES 
THE POWER OF A LANGUAGE, AND REDUCES THE NEED FOR SPECIALISED 
BUILTIN FUNCTIONS. 

THE HDST SYSTEM IS ASSUMED TO INCLUDE AT LEAST ONE COMMAND 
EXECUTOR AND SOME STORAGE ALLOCATION ROUTINES. A SUB-CLASS OF 
COMMANDS ARE THOSE WHICH ACCEPT DaTa AND/OR ARGUMENTS FROM RtX AND 
RETURN THEIR RESULT IN A STORAGE BLOCK WHICH IS USABLE by’rEX. 
THIS SUBCLASS CAN BE TeRMlD 'FUNCTIONS' AND INCLUDED IN THE 


r 
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LANGUAGE USING THE CONVENTIONAL NOTATION OF PAREntHEspc uiTrt 

COMMAS TO SEPARATE THE ARGUMENT EXPRESSIONS. ^ ’ 

FOR EXAMPLE ThE FUNCTION 'SUBSTR' COULD BE IMPLEMENTED bY A 
SEPARATE MODULE. __ 

THE SYNTAX DESCRIPTION WOULD THEREFORE BE: if a sy 1S 

FOLLOWED IMMEDIATELY uY A " ( M THEN 1Tb VALUE ... WHICh » Recall" WILL 
BE ITS NAME UNLESS IT HAS BEEN USED AS A VaPIA0EE) 1 S TAKEN TO BE A 
FUNCTION NAME. EACH EXPRESSION FOLLOWING THE ( AND SEPARATED BY 
IS EVALUATED, AND THE FUNCTION IS INVOKED WH^N THE FINal ••)'• IS 
INTERPRETED. _ 

THIS GIVES A 'NORMAL* SYNTAX FOR FUNCTION CALLS, WITHOUT THE 
NEED FOR A NEW CLAUSE FOR EVERY COMMAND. 

THREE PACKS OF USEFUL BASIC FUNCTIONS ARE SUPPLIED WITH THE CMS 
VERSION OF REX: THESE WILL BE LOADED AUTOMATICALLY IF ANY FUNCTION 
CONTAINED IN THEM IS INVOKED. 


2.7 NO REQUIREME NT FOR SELF-MODIFYING £X£C£. 


EXEC AND EXEC 2 BOTH PERMIT SELF-MODIFYING EXECS. THIS IS A 
"NICE" FACILITY WHICH HOWEVER IS TYPICALLY NOT USED. I N FACT, THE 
ONLY TIME IT NORMALLY OCCURS IS WHEN ONE EDITS AN 'EDIT' EXEC: AND 
THEN IT IS USUALLY MORE OF AN EMBARRASSMENT THAN A HELP. 

REX THEREFORE ASSUMES THAT ALL EXECS ARE READ ONLY. THIS 
IMPLIES THAT: A) THE ENTIRE EXEC IS READ INITIALLY (INEFFICIENT FOR 
LONG FILES, PERHAPS); AND B) STATEMENTS THAT MIGHT BE 
RE-INTERPRETED (E.G. IN LOOPS) NEED ONLY BE PARSED ONCE, FOR 
IMPROVED PERFORMANCE. 

IN ADDITION, IT CAN INTERPRET DATA DIRECTLY FROM STORAGE: SO 
AVOIDING THE OVERHEAD OF LOADING ALL PROGRAMS (EXECS) FROM DISK. 

THE 'READ/ONLY* RESTRICTION ALSO OPENS UP THE ATTRACTIVE 
POSSIBILITY OF COMPILATION OR PART COMPILATION OF THE LANGUAGE: A 
POSSIBLE IMPLEMENTATION MIGHT THEREFORE CONSIST OF A 'COMPILER* 
WHICH PRODUCES AN 'OBJECT FILE* WHICH COULD THEN BE VERY 
EFFICIENTLY INTERPRETED BY THE REX EXEC PROCESSOR, WITH REAL 
PERFORMANCE IMPROVEMENTS (A FACTOR OF AT LF AST 4 MIGHT BE 
TMTcplDc-J-rw^ 0 !^ VER ’ ThERE IS AN IDENTIFIABLE NEED FOR THE 'FULLY 
INTERPRETIVE METHOD OF EXECUTION, AND THIS HAS BEEN IMPLEMENTED 


■EiicE." EXEC/HRnn^fti^ COMMUN I S at 


ORDER T TD S CA»py E nM DESIRA81 - E T0 SU SPEND ThE EXECUTION OF AN EXEC I 
HAVING TO ENTER THE D1 ^Pr UE AT WITH ANDTHER tXEC OR PR0GRA ^ 

OBVIOUS EXAMPlI OF THIS IS ?J TT no E TQP ‘ F0R EACH IN Sc NEEDS i 
GET ADDITIONAL OR FEEDBACK tEESJS MACR0S ’ WHERE THE E * T 

tuUBACK INFORMATION FROM THE CALLER. 
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, S L)BCOMMANi Dl 

THE YK.TSVC CMS PACKAGE IMPLEMENTS AN E FF EC ,r c^Hl 5 SY ^^* 
HANDLER* AND IT SEEMS SENSIBLE AND PRACTICAL TO g»rIL ii Y " A TO t s 

ONE REX INSTRUCTION IS USED TO CONTROL THE FA R oiJTE^ n T Th E 
NNN ’ WILL CAUSE ANY FOLLOWING COMMANDS TO Bt rE kONM C ALL 
ENVIRONMENT NAMED NNN, AND ’ADDRESS' (NO NAME) " E r iMMiki.* 
FOLLOWING COMMANDS TO THE PREVIOUSLY SELcCic ^ '«ND Tq 

SIMILARLY ’ADDRESS NNN EXPRESSION' WILL SEND JUi> 

THE IDENTIFIED ENVIRONMENT. 

programS which 

REX IS FULLY COMPATIBLE WITH EXEC 2, AND t q USt r Ex 

SUCCESSFULLY INTERFACE WITH EXEC 2 SHOULD BE ouS ADVANTAGES. 
WITHOUT ANY CHANGES BEING NECESSARY. THIS HAS OBV 



r 

r 
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2. B£X L ANGUAGE DE F IN HUM 


LANGUAGE DEFINITION FOR REX VERSION 2.01. 

NOTE: THIS DEFINITION ATTEMPTS ^0 ® E A C 0MPLETE DESCRIPt^,^ OF 
THE SYNTAX* WHICH IS NOW “FROZEN 11 IN THfc SENSE THAT iNLGMPATlbLE 
CHANGES WILL NOT BE MADE EXCEPT IN EXTRA-ORDINARY CIRCUMSTANCES. 
PLEASE BRING ANY ERRORS, OMISSIONS, OR *ECESS,ARY CLARIF I C ATiONS 
TO THE ATTENTION OF THE AUTHOR: SEE AUDRESS ON THE FRONT OF THIS 


AND GENERAL SYNT AX 



A REX PROGRAM IS BUILT UP OUT OF A StRIES OF 'CLAUSES' WHICH ARE 
COMPOSED OF: ZERO OR MORE BLANKS (WhlCH ARE IGNORED); A SEQUENCE OF 
TOKENS (SEE BELOW); ZERO OR MORE BLANKS (AGAIN IGNORED); a.NU ThE 
DELIMITER »;" (SEMICOLON) WHICH MAY BE IMPLIED BY LINE-END, CERTAIN 
KEYWORDS, OR THE COLON EACH CLAUSE IS SCANNED BEFORE EXECUTION 

FROM LEFT TO RIGHT AND THE TOKENS COMPOSING IT ARE IDENTIFIED. COMMENTS 
ARE REMOVED, AND MULTIPLE BLANKS (EXCEPT WITHIN STRINGS) ARE CONVERTED 
TO SINGLE BLANKS. BLANKS ADJACENT TO SPECIAL CHARACTERS (SEE BELOW) ARE 
ALSO REMOVED. 


2.1.1 IOtiEliS 

THE LANGUAGE IS COMPOSED OF TOKENS (OF ANY LENGTH, UP TO AN 
IMPLEMENTATION RESTRICTED MAXIMUM) WHICH ARE SEPARATED BY BLANKS OR BY 
THE NATURE OF THE TOKENS THEMSELVES. THE CLASSES OF TOKENS ARE: 

COMMENTS: 

ANY SEQUENCE OF CHARACTERS ON ONE OR MORE LINES WHICH ARE 
DELIMITED BY */*' AND '*/'. COMMENTS MAY BE NESTED, WHICH IS 
TO SAY THAT '/*• AND •*/• MUST PAIR CORRECTLY. COMMENTS ARE 
IGNORED BY THE INTERPRETER (ANO HENCE MAY BE OF ANY LENGTH), 
BUT DO ACT AS SEPARATORS. 
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<S AND DEgfP). B Is E T S, 

DOUBL£- q U° t ^ USE »I Tq 

-• ~ utLINITED BV 1 S TRl NG Is , 

■ A STR1NG DELIMITED BY '* rD A R E MO dIF1 ED By 

AND ITS contents will never be tH e STRiJl 

rLcM AT IF Fi:) LLOWED IMMEDIATELY B V A lF FOLLq w ^ 
rAKEN Tfl RF TUC IU«C nc * CHMrTTON, AN ?„TWG: tD 


SINGLE ‘oSoJ^cScTet 1 ^. ‘"f "n 

LITERAL rnuu it a STR1NG DELIMITED by 
RE n AND ITS CONTENTS WILL 

.. T * 1h AT if FOLLOWED IMMEDIATELY BY » 

IMMFn?irIfv EN T0 BE THE NAME 0F A FUNCTION; AI ^ N G 

IMMEDIATELY BY an *X* THEN IT SHOULD BE A HEX STRI 


HEX STRINGS: 


SEQUENCE OF PAIRS OF HEXADECIMAL DIGITS ^'^jnGU 
OPTIONALLY SEPARATED BY BLANKS, DELIMITED 


(C- 9 » t A , F ! A~F) 


DOUBLE- QUOTES AND IMM ED I AT ELY ^FOLLOWED BY FORme. 1 

OR *X* TMTC DCDOCrr-... rr . „„ r M C f. DNS T AN I FORME 


OR X*. THIS REPRESENTS A CHARACTER STRING CONST MED 

BY PACKING THE HEXADECIMAL CODES GIVEN. THE BLANKS, WHICH 
MAY ONLY BE PRESENT AT BYTE BOUNDARIES, ARC AID 

READABILITY AND ARE ENTIRELY IGNORED. 


FROM THE 


GROUPS OF ANY EBCDIC CHARACTERS, SELECTED 
ALPHABETIC AND NUMERIC CHARACTERS (A-Z, A-Z, C-9) AND/OR 
FROM THE CHARACTERS . ? AND UNDERSCORE, ARE CALLED 

SYMBOLS. ANY LOWER CASE ALPHABETIC CHARACTER IN A SYMBOL IS 
TRANSLATED TO UPPER CASE. IF THE SYMBOL THEN MATCHES A REX 
KEYWORD AND IT IS AT THE BEGINNING OF A CLAUSE AND IT 1S NOT 
FOLLOWED BY AN ••=», THEN IT IS INTERPRETED SPECIALLY. 
OTHERWISE IF IT DOES NOT BeGIN WITH A DIGIT (C~<?) OR A 
PERIOD (OR IF IT IS JUST A SINGLE PERIOD) THEN IT IS 
POTENTIALLY A VARIABLE AND MAY HAVE A VALUE. IF IT DOES NOT 
HAVE A VALUE THEN IT IS INTERPRETED AS THE CHARACTER STRING 
CONSISTING OF THE CHARACTERS OF THE SYMBOL (AS THOUGH THEY 
OCCURRED WITHIN QUOTES). 


ARE CHARACTFR STRINGS CONSISTING OF ONE CR MORE 
DECIMAL DIGITS OPTIONALLY PREFIXED BY A PLUS OR MINUS SIGN, 
AND OPTIMALLY INCLUDING A SINGLE PERIOD ("."). NUMBERS MAY 
HAVE LtADING BLANKS (BEfORE AND/OR AFTER THP SIGN IF ANY) 
AND MAY HAVE TRAILING BLANKS. EMBEDDED BLANKS A^E SI 
PtRMITTED. NOTE THAT A SYMBP1 (abhufi mav d - A ARt NU 
SO MAY A STRING CONSTANT. VE ’ MAY BE A DUMBER AND 


: SEQUENCES X >= <= ARA >^< S ^= = = ~J j, A V np > < AND THE 

ONE OR MORE BLANK CHARACTER(S) , WHERE THEy^fl' D r EN IN 

Expressions but are not adjacent to another operator^ also 


act as an operator. 



« 
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SPECIAL CHARACTERS! . , ,» rOGFTHER WITH rur ... 

THE CHARACTERS , ; s ) ( S-cpcriii [rf THE INDIVIDUAL 

CHARACTERS FROM THE OPERATORS HAVc SP.iC1AL SIGNIFI CANCE WHEN 
FOUND OUTSIDE STRINGS, AND CONSTITUTE E SET OF •'speCIAL 
CHARACTERS. THEY ALL ACT AS. T ° 1 J\^ RS » AND BLANKS 

ADJACENT TO ANY OF THESE ARE 1 J H THE EXCEPTION 

THAT A BLANK ADJACENT TO THE OUTSIDE °!L A PARENTHESIS IS 
ONLY DELETED IF IT IS ALSO ADJACENT TO ANOTHER SPECIAL 
CHARACTER. 


FOR EXAMPLE THE CLAUSE ±R££££lL1 & ± J C « a y°ha5'- 0F 

A STRING, A BLANK OPERATOR, A SYMBOL (WHICH MAY HAVt 
SpeSSE'aSd A SECOND SYMBOL (WHICH ALSO IS A NUMBER, 
BETWEEN THE "b" AND THE AND BETWEEN THE + THt, 3 

HOWEVER ONE OF THE BLANKS BETWEEN THE REPEAT AND THE B 
OPERATOR. 


F IVe TOKENS! 
A VALUE), AN 
THfc BLANKS 
are REMOVED, 
REMAINS AS AN 


2.1.2 IMPLIED SEMICOL ONS AM 2QtAlI,NUA.I10!i2 

REX WILL NORMALLY ASSUME (IMPLY) A SEMI-COLUN AT THE END OF EACH 
LINE, EXCEPT IF: 

A) THE LINE ENDS IN THE MIDDLE OF A STRING 

B) THE LINE ENDS IN ThE MIDDLE OF A COMMENT 

C) NEITHER OF THE ABOVE CASES HOLD, BUT THt LAST NON-COMMENT TOKEN WAS 
A COMMA. IN THIS CASE THE COMMA IS FUNCTIONALLY REPLACED BY A 
BLANK, AND HENCE ACTS AS A 'CONTINUATION CHARACTER*. NOTE THAT ThE 
COMMA WILL REMAIN IN EXECUllON TRACtS. 

THIS MEANS THaT SEMICOLONS NEED ONLY BE INCLUDED WHEN THERE IS MORE THAN 
ONE CLAUSE ON A LINE. 

(NOTE: THE TWO CHARACTERS FORMING A DOUBLE UUOTE WITHIN A STRING, OR THE 
COMMENT DELIMITERS "/*" AND "*/" SHOULD NOT BE SPLIT BY A LINE ENu SINCE 
THEY COULD NOT THEN BE RECOGNISED CORRECTLY: AN IMPLIED SEMICOLON WOULD 
BE ADDED.) 

(NOTE: SEMI-COLONS ARE ADDED AUTOMATICALLY bY REX AFTER COLONS, AND 

AFTER CERTAIN KEYWORDS WHEN IN THE CORRECT CONTEXT. THE KEYWORDS THAT 
MAY HAVE THIS EFFECT ARE: ELSE OTHERWISE THEN. THESE SPECIAL CASES 
REDUCE TYPOGRAPHICAL ERRORS SIGNIFICANTLY) 
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2.2 p VPR ESSI'ONS ANIO OPERAT O RS. 

( sv M r D rs, CL sra!^,^ 

.3*1 .sroaTs^ sm^.! s 

ALWAYS TAKEN TO Bt A LITERAL CONSTANT. WHICH CASE THEY Aug 

OTHER SYMBOLS MAY BE THE NAME OF A VARIABLE, IN^ 1 r£ NEEDED DURi Ng 
REPLACED BY THE VALUE OF THAT VARIAbLc AS SOON (NOTE 1 hA1 LOWER 

EVALUATION. OTHERWISE THEY ARE TREATED AS A 1 A SYMBOL „ AY 

CASE CHARACTERS WILL HAVE BEEN TRANSLATED TO UPPER 

ALSO BE "COMPOUND" - SEE LATER IN THIS DOCUMENT. ^ ^ 

EVALUATION OF AN EXPRESSION IS J- E ^ T ° ** E BRAIC » MANNER 
PARENTHESES AND BY OPERATOR PRECEDENCE IN * M US “ F L TY( , ELE SS CHAkACT E r 
(SEE BELOW). SINCE ALL DATA IS IN THt iqn j$ j t5E lF A CHARACTER 

STRINGS, THE RESULT OP AN *md RESULTSMAY BE THE "NULL STRING” (A STRING 
STRING. ALL TERMS, DATA, AND RESULI3 
OF LENGTH 0). 

, cv _ aT Twp prfPIX OPERATIONS) ACT ON TWO TERMS, WHICH 
THE OPERATORS 1E * Cc ' T Q ^ / K qr 6 RACKETED SUb-EXPRESSIONS. PREFIX 
MAY BE INTERMEDIATE RESULTS B SU B-EX PR E S SION. THERE ARE FOUR 

OPERATORS ACT ON THE FOLLOWING TERM uk 

type OF operator: 

S TRING Q.Q£iL AiEHAllOM : 


(BLANK) 


CONCATENATE TWO TERMS WITH A SINGLE BLANK IN BETWEEN 
CONCATENATE WITHOUT AN INTERVtNING B LANn 


CONCATENATION WITHOUT A BLANK MAYBE FORCED BY USING THE f| 
OPERATOR* bSt IT IS USEFUL TO KNOW THAT IF A STRING AND A SYMBOL ARE 
JUXTAPOSED, THEN THEY WILL BE CONCATENATED DIRECTLY. 

E.G: FRED*?* WOULD EVALUATE TO *37.3?* IF THE VARIABLE "FRED" 

HAD THE VALUE *37.3*. 

ARlIMMEXIi: 

+ ADD 

SUBTRACT . 

* MULTIPLY 

/ DIVIDE (AS PER 370) 

// DIVIDE AND RETURN THE REMAINDER (NOT MODULO) 

PREFIX - NEGATE THE FOLLOWING TERM (WHICH MOST BE NUMERIC) 

PREFIX ♦ TAKE THE FOLLOWING TERM (WHICH MUST BE NUMERIC) AS IS. 

SEE THE SECTION ON "NUMERICS" FOR DETAILS OF ACCURACY AND THE FORM aT 
OF VALID NUM36RS. 
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THE COMPARATIVE OPERATORS RETURN THE VALUE THE RESULT OF THE 

COMPARISON IS TRUE, OR *U* OTHERWISE. 1> I T *™S INVOLVED ARE 

NUMERIC, THEN A NUMERIC COMPARISON (IN WHICH LEA NG ZEROS ARE IGNORED) 
IS' EFFECTED, OTHERWISE BOTH TERMS ARE TREA eD AS CHARACTER STRUGS (THE 
SHORTER IS PADDED WITH BLANKS ON THE RIGHT). ™E - OPERATOR MAY ^ 
USED TO TEST FOR AN EXACT MATCH BETWcEN TWO STRINGS IN l HIS caS E NO 
PADDING OR ZEROS REMOVAL TAKES PLACE. 

= . true IF THE TERMS ARE EQUAL (WHEN PADDED WITH BLANKS ETC.) 

__ TRUE IF THE TERMS ARE EXACTLY EQUAL (IDENTICAL) 

-,= NOT EQUAL (INVERSE OF =) 

> GREATER THAN 

> = , -,< GREATER THAN OR EQUAL TO, NOT LESS THAN 
< = , -.> LESS THAN OR EQUAL TO, NOT GREAT ER TmAN 

LOGICAL ( BOOLEA N): 

A CHARACTER STRING IS TAKEN TO hAVc Tht VALUE "FALSE'* IF IT IS 'O'. 
AND "TRUE" IF IT IS A *1*. THE LOGICAL OPERATORS TAKE ONE OR TWO SUCH 
VALUES (VALUES OTHER THAN 'O' OR *1' ARE NOT ALLOWED) AND RETURN 'O' OR 
•l* AS APPROPRIATE: 


8 RETURNS 
| RETURNS 
88 RETURNS 
PREFIX LOGICAL 


•1* IF BOTH TERMS ARE "TRUE" 

•1* IF EITHER TERM IS "TRUE" 

* I * IF EITHER (NOT BOTH) IS "TRUE" (EXCLUSIVE 
"NOT" (NEGATE: "TRUE" -> 'O', "FALSE" -> *1*) 


OPERATOR PRIORITIES : 

EXPRESSION EVALUATION IS MODIFIED BY OPERATOR PRECEDENCE. FOR 
EXAMPLE, (MULTIPLY) HAS A HIGHER PRIORITY THAN "+" (ADD), SO 3+2*5 

WILL EVALUATE TO *13' (RATHER THAN THE ‘25* WHICH WOULD RESULT IF STRICT 
LEFT TO RIGHT EVALUATI ON . OCCUKRED). THE ORDER OF PRECEDENCE OF ThE 
OPERATORS IS (HiGHEST AT THE TUP): 


PREFIX - AND • 


r (PREFIX OPS.) 

(MULTIPLY AND DIVIDE). 

(ADD AND SUBTRACT ) 

(CONCATENATION, WITH OR WITHOUT BLANK) 
(COMPARISON OPERATORS) 

(AND) 

(OR, EXCLUSIVE OR) 



O 
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S Sf E ™ Ar r " E fOLLOWJNO S y„ B0LS Rte ^r^ lL ' Wl,H 

A HAS THE VALUE *3* 

DAY HAS THE VALUE •MONDAY' 

THEN: 


A + 5 WILL EVALUATE TO 

A—4*2 ==> 

(A+l)>7 = = > 

•»==•« ==> 

(A+l)*3=I2 ==> 

TODAY IS DAY ==> 

•IF IT IS* DAY ==> 

SUBSTR( D A Y, 2» 3 ) ==> 

• 'XXX* • ==> 


•8» 



•C • 


•TODAY IS MONDAY* 
•IF IT IS MONDAY' 
•ONO* /* SUBSTR 
• XXX • 


/* 

/* 

/* 


FALSE 
FALSE 
TRUE . 



1S A FUNCTION */ 


•I 

p 

o 

o 
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a.a £.LA£.£££ HE MMillffli 

THE CLAUSES MAY BE SUBDIVIDED INTO FIVE TYPES: 

CLAUSE CONSISTING OE ONLY BLANKS AND/OR C Qm M ents , OR 
THE KEYWORD "THEN 1 ' ALONE , 1 o CUMP LE TE L Y lGN0R tLj tN Si «EX 
(EXCEPT THAT COMMENTS MAY BE TRACED). BY 


PAbE I^ # 


- and 


_ pJ B£LS 

SIGNAL 


'•SYM80L=EXP R6ssinN „ THIS 


32;;= 7 


! A LABEL : T <- . , 

A CLAUSE WHICH ENDS IN A COLON IS A LABEL, AND sh0 uLD 
CONSIST OF A SINGLE SYMBOL FuLLUWFD BY THE COlq^ 

ARE USED TO IDENTIFY THE TARGETS OF CALL , 
INSTRUCTIONS. 

‘ AN ASSIGNMENT (SECTION 3.A): 

A SINGLE CLAUSE WITH THE FORM 
GIVES A VARIABLE A (NEW) VALUE. 

= A CONTROL INSTRUCTION (SECTION 3.6): 

ONE OR MORE CLAUSES, THE FIRST OF WHICH STARTS with a REX 
KEYWORD WhiCH IDENTIFIES THE INSTRUCTION. THESE CONTROL 
THE EXTERNAL INTERFACES, THt FLUW UF CUnTRQl, tTc . S QME 
INSTRUCTIONS MAY INCLUDE NESTED I NSTRUCTIONS. 

‘ A COMMAND (SECTION 3.5): 

A SINGLE CLAUSE CONSISTING OF AN EXPRESSION. THE 
EXPRESSION IS EVALUATED AND PASSED AS A COMMAND STRING TO 
THE HOST OR OTHER ENVIRONMENT. 


<*•5 I 64 
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2.£t assignment in structions 

ANY CLAUSE OF THE FORM: 

"SYMBOL=EXPRESS ION" 

IS TAKEN TO BE AN ASSIGNMENT STATEMENT. 

IaS DESCRIb^q 

the SYM8GL IS ANY VALID COLLECTION OF CHARACTER 5 QR A PERi Qn 
ABOVE) BUT EXCLUDING THOSE BEGINNING WiTH A DIGIT < 0 ';' nU MBER). t-. 
(EXCEPT FOR A PERIOD ON ITS OWN, WHICH CANNOT BE A vAL tarGET OF am 
MAY ALSO BE 'COMPOUND* (SEE BELOW). BY BEING THE ' v .rj ABLE : Vm 
ASSIGNMENT IN THIS MANNER, IT IS CONTEXTUALLY DECLARED AS A * lEC T10N nt 
OTHER WORDS, IN ALL SUCCEEDING STATEMENTS THIS PARTICULAR Du ui- 

characters within an expression represents a string in storage. 

NOTE: SINCE AN EXPRESSION MAY INCLUDE THE OPERATOR '" ’ A 

STATEMENT MAY CONSIST PURELY OF AN EXPRESSION (SEE NEXT SECTION», 'HERE 
IS A POSSIBLE AMBIGUITY HERE. REX THEREFORE TAKES ANY CLA ,^' "" ICH 
STARTS WITH A SYMBOL AND WHOSE SECOND TOKEN IS TO 8E AN ASSIGNMENT 

STATEMENT, NOT AN EXPRESSION. 

THIS IS NOT A RESTRICTION, SINCE FOR EXAMPLE THE CLAUSE MAY BE 
EXECUTED AS A COMMAND BY PUTTING A •* BEFORE THE FIRST NAME, OR BY 
ENCLOSING THE ENTIRE EXPRESSION IN PARENTHESES. 

SIMILARLY, IF A PROGRAMMER ACCIDENTALLY USES A REX KEYWORD AS A 
VARIABLE .NAME, THIS SHOULD NOT CAUSE CONFUSION - FOR EXAMPLE THE CLAUSE: 

ADDRESS= * 1C DOWNING STREET* 

WOULD BE AN ASSIGNMENT STATEMENT, NOT AN ADDRESS INSTRUCTION. 




# 
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2.2 COMMANDS IQ Ili£ dQSI 


THE 'HOST SYSTEM' FOR 


REX IS ASSUMED TO INCLUDE AT L Eact 

"STACK") CAPABLE OF HANDLING CHARACTER STRINGS, AND AT , ° NE QUB ^ 
ENVIRONMENT FOR EXECUTING COMMANDS. ONE OF TritSE ENVIR Qn , Me J-EONE 
SELECTED TO BE THE 'CURRENT' ACTIVE ENVIRONMENT. L ^S MAY Bfc 

EXECUTING COMMANDS USING ThE CURRENTLY ADDRESSED ENVIRo^- v RF 

ACHIEVED USING A STATEMENT OF THE FORM: tNT MaY 

"EXPRESSION" 

THE EXPRESSION IS EVALUATED, RESULTING IN A CHARACTER STRimt iumtTH 
MAY BE THE NULL STRING). IF THE STRING IS NOT NULL, IT IS 1 H £n dJSabFD 
AS APPROPRIATE AND SUBMITTED TO THE HOST. FOR EXAMPLE, I F The H . f * £ 
CMS, THEN THE STRING WOULD BE 8-BYTE TOKENI SED AND A NEW-FDRM’PL 1ST 
WOULD BE BUILT. 

AS AN EXAMPLE OF HOW A CMS COMMAND MIGHT BE ISSUED, THE SEQUENCE: 


WOULD RESULT IN THE PLIST: "STATE JACK RABBIT AI .. BE ING> 

SUBMITTED TO CMS. OF COURSE, THE SIMPLE EXPRESSION 'STATE JaC< RABBIT 
Al* WOULD HAVE THE SAME EFFECT IN THIS CASE. 

ALL COMMANDS RETURN AN INTEGER RETURNCODE . THIS IS PLACED IN THE 
VARIABLE *RC WHEN the COMMAND HAS FINISHED EXECUTING. BY CONVENTION A 
RETURNCODE OF 0 MEANS 'SUCCESSFUL COMPLETION'. 

ALTERNATIVE EXECUTION ENVIRONMENTS MAY BE SELECTEO BY THE *ADDRFSS* 
INSTRUCTION (Q.V.) WHICH MAY ALSO BE USED TO ISSUE COMMANDS. 

THE DEFAULT ENVIRONMENT WILL DEPEND ON THE CALLER OF REx: FOR 
EXAMPLE IF CALLED FROM CMS, THEN THE DEFAULT ENVIRONMENT WOULD BE CMS, 
PR0PERLY FR0M M EDITOR, THEN THE DEFAULT ENVIRONMENT WOULD BE 
APPENDIX^’ * DiSCUSSI0,N 0r_ THIS MECHANISM IS INCLUDED BEcOW IN ThE 
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1.6. CONTROL I NSTRUCTIONS 

aS 0VE lN0T AbL Y 

SEVERAL OF THE MORE POWERFUL FEATURES DES ^. 1 J cTlON S ^ 
FUNCTIONS) REDUCE THE NUMBER OF.PRIMITIVE REX lNSI*u A S Nq 

arBIT^^ 

NOTE THAT THE CHOICE OF KEYWORDS IS FAIRLY " h£M . 

EARLIER, THERE ARE ARGUABLE ALTERNATIVES TO MOST OF A piTAL-S OENQ^g 

IN THE FOLLOWING DIAGRAMS, SYMBOLS ‘WORDS) A ™™ N 

KEYWORDS, OTHER WORDS (SUCH AS 'EXPRESSION JP^JyORDS A ^ V OKE 
SYMBOLS AS DEFINED ABOVE. NOTE HOWEVER ThAT ™ E n , m 0 AL L LIMITubc 

DEPENDENT: THE SYMBOLS "IF", "IF" AND "IF" OF TH^F A LI^ 

INSTRUCTION SHOWN BELOW AS "IF". NOTt AlSO THAT Tri g £ND SYMR^’, 

SHOWN MAY OFTEN BE OMITTED AS THEY WILL BE IMPLIED AND 0fJL ^ Ql > 

A 'THEN* IN THE CONTEXT OF A CLAUSE (It AS THE FIRM _ 

ACTS AS A SEMICOLON AS IS THEREFORE IGNORED. £ j N STRUCTIONS. 

THE CHARACTERS < AND > OtLlMII OPTIONAL PaRTS OF 


1.6.1 addSjLH 

ADDRESS <ENVIR0NM ENT <EXPRE SSION>>; 


I 


WHERE "ENVIRONMENT" IS A SINGLE SYMBOL OR STRING. 
IS A VARIABLE THEN ITS VALUE IS USED. 


I 

I 

IF THE SYMBOL | 


THIS INSTRUCTION IS USED TO EFFECT A TEMPORARY OR PERMANENT CHANGE 
TO THE DESTINATION OF COMMAND(S). THE CONCEPT OF ALTERNATIVE SUBCOMMAND 
e.vtronment^i^descrtbe^i^thEiAppendtx. £valuated> AND TH£ result 

COMMAND STRING WILL BE ROUTED TO THE ENVIRONMENT WITh THE NAME GIVEN IN 
"ENVIRONMENT". AFTER EXECUTION OF ThE COMMAND, THE ENVIRONMENT M1LL BE 
SET BACK TO WHATEVER IT WAS BEFORE, THUS GIVING A TEMPORARY CHANGE OF 
DESTINATION FOR A SINGLE COMMAND. 

IF NO EXPRESSION WAS SPECIFIED, THEN A LASTING CHANGE OF DESTINATION 
OCCURS: ALL FOLLOWING COMMANDS (EXPRESSIONS NO I PRECEDED BY A REX 
KEYWORD) WILL BE ROUTED TO THE COMMAND ENVIRONMENT WITH THE NAME GIVEN, 
UNTIL THE NEXT ADDRESS INSTRUCTION IS EXECUTED. 

IF NO ARGUMENTS ARE GIVEN, COMMANDS WILL BE ROUTED BACK TO THE 
ENVIRONMENT THAT WAS SELECTED BEFORE PREVIOUS "ADDRESS <EnVIRGNMENT^ 11 
INSTRUCTION, AND THE CURRENT ENVIRONMENT NAME IS SAVED. REPEATED 
EXECUTION OF "ADDRESS" WILl THEREFORE "TOGGLE" THE COMMAND DESTiNAT ION 
BETWEEN TWO ENVIRONMENTS. 

IF THE NULL STRING " OR A BLANK STRING IS GIVEN AS THE ENVIRONMENT 
NAME, THEN THE HOST ENVIRONMENT (E.G. CMS) IS IMPLIED. THIS IS ALSO THE 
ENVIRONMENT SELECTED IF AN ADDRESS INSTRUCTION WITHOUT ARGUMENTS IS THE 
FIRST ADDRESS INSTRUCTION EXECUTED. IN THE CMS IMPLEMENTATION, t h p N* m£ 
"CMS" ALSO IMPLIES THE HOST COMMAND ENVIRONMENT. 
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1 . 6 . 2 , 


ARGS <TEMPLATE>; ! 
WHERE "TEMPLATE" IS A LIST UF SYMBOLS SEPARATED BY BLANKS AND/OR j 
"TRIGGERS" (SPECIAL CHARACTERS OR STR1 ^f„mi,,i. 


UNLESS A SUBROUTINE IS BEING EXECUTED (SEE THE CALL INSTRUCTION) THE 
INPUT PARAMETERS TO Tht PROGRAM, PRECEDtD BY THE NAME OF THE PROGRAM, 
U1M RF REAn AS ONE STRING, AND THEN PARSED IN t a AL L Y THE SAME WAY AS 
fJrVh! INSTRUCT ION. (ARGS CAUSES TOKEN S TO HE TR ANSLAl(ED TO UPPER 

CASE, USE THE PARSE ARGS INSTRUCTION IF THIS IS NET DESIRED). 

IF A SUBROUTINE IS BEING EXECUTED, THEN THE STRING USED WILL BE THE 
ARGUMENT STRING PASSED TO THE SUBROUTINE (PREFIXED WITH THE NAME OF THE 
SUBROUTINE). 

THE ARGS (AND PARSE ARGS) INSTRUCTIONS MAY BE EXECUTED AS OFTEN AS 
DESIRED (TYPICALLY WITH DIFFERENT TEMPLATES) AND WILL ALWAYS PARSE THE 
■ SAME^CURRENT INPUT STRING. THERE ARE NU RESTRICTIONS ON THE LENGTH OR 
CONTENT OF THE DATA PARSED EXCEPT THOSE IMPOSED tY THE CALLER. (E.G. 
FROM CMS COMMAND LEVEL, THE STRING WILL NOT EXCtED 13L CHARACTERS). 

NfiTF FOR FXFC US C RS : UNLIKE EXEC AND EXcC 2 , THE ARGUMENTS PASSED TO 
REX EXECS CAN ONLY BE USED AFTER EXECUTING EITHER THE ARGS OR PARSE ARGS 
COMMANDS. THEY ARE NOT IMMEDIATELY AVAILABLE IN PREDEFINED VARIABLES AS 
IN THE OTHER LANGUAGES. 
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"""a 

I 


CALL NAME <EXPRtSSlON>; . 

iMiiuni mi tin i ^ l' lf: 

CALL IS USED TO INVOKE AN INTERNAL SUBROUTINE. .JJj THE .^EXECUTInw 
GIVEN) IS EVALUATED AND THEN PREFIXED WITH thE t N ^oTNG DUB 1, ' , “ 1lL aCCESc 
THE COMPLETE STRING IS THEN USED AS THE ARGUMENT S ™L,, |C TlON Wl Ss 

AND PARSE ARCS INSTRU 

- . gXAClLY Th £ 


-c previously known" 

variables maY used Tq 


OF THE SUBROUTINE (l.E. THE ARGS 

THIS STRING RATHER THAN THE ONE ACTIVE PREVlOUSLY ')• uS iNG E nQ-LOnp : 

THE CALL THEN CAUSES A BRANCH TO THE LABEL NAME pENO lNG “ LQ0P S 
SAME MECHANISM AS THE SIGNAL INSTRUCTION (EXCEPT THAI jnSTRUCTION IS 
ETC. ARE NOT DEACTIVATEU). THE LINE NUMBER OF THE 
AVAILABLE IN THE VARIABLE "SIGL'» AS A DEBUG AID. 

DURING EXECUTION OF THE SUBROUTINE, ALL VARIABLES^ 

ARE NORMALLY ACCESSIBLE. mOWEVER, THE PROCEDUR 
SET UP A LOCAL VARIABLES ENVIRONMENT TO PROTECT 

CALLER FROM EACH OTHER. INSTRUCT ION, 

EVENTUALLY THE SUBROUTINE SHOULD EXECUTt A . Rt , nwIN G THE ORIG 
AT THAT POINT CONTROL WILL RETORN TO THE LLAUSt F0E1 -U QN T hE RETURN 
CALL, WITH THE VARIABLE "NAME" SET TO THE VmLUE GIV 
STATEMENT (WHICH MAY BE NULL). 

SUBROUTINES MAY BE NESTED TO ANY DEPTH. 

NOTE THAT THE NAME GIVEN IN THE CALL 
SYMBOL (NOT A LITERAL STRING) WHICH IS TREATED LITERALLY. 

NOTE ALSO THAT EXECUTING A SIGNAL WHILE WITHIN A 
•SAFE*. THAT IS, OO-LOOPS ETC. TH AT WERE ACTIVE JHE S 

CALLED ARE NOT DEACTIVATED. .* r . 


1GINAL 


STRUCT ION MUST BE A VALID 

Y. 

A SUBROUTINE IS 
HE SUBR 

"Tbut those currently active are). 


example : 

/* RECURSIVE SUBROUTINE EXECUTION... */ 

ARGS NAME X 
CALL FACTORIAL X 
SAY X» =* FACTORIAL 
EXIT 

FACTORIAL: PROCEDURE /* CALCULATE FACTORIAL BY RECURSIVE */ 

ARGS XX N INVOCATION... *1 

IF N=C THEN RETURN 1 
CALL FACTORIAL N-l 
RETURN FACTORIAL*N 


§ 

$ 

C 

r 


r^ 
o 


n 1 

f) 

fT) 

m 




* 
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"d o"<R£ PE T1TOR>"<CONOIT10 NAL > ? <INSTRuCTlON-LIST> END; 

Uherf RFPtTITOR IS EITHER OF! 

WHERE REPtTIT R £XPRI <T0 exprt> <By EXPRB> 

EXPRR 

ANO CONDITIONAL IS EITHER OF: 

WHILE EXPRW 

AND INSTRUCTION-LIST IS: ANY SEQUENCE OF^INSTRUCTIONS 


THE TO AND BY PHRASES MAY BE IN REVERSE ORDER IF DESIRED. 

EXPRR, EXPRI, EXPRB, AND EXPRT (IF PRESENT) MUST EVALUATE 
NUMBERS. . 

EXPRW OR EXPRU (IF PRESENT) MUST EVALUAlb TO 1 OR 0*. 

EXPRB DEFAULTS TO 'I', IF RELEVANT. 

THE INSTRUCT ION(S) IN INSTRUCTION-LIST MAY INCLUDE ANY OF 1HE MOR 
COMPLEX CONSTRUCTIONS SUCH AS IF, SELECT, OR THE DO INSTRUCTION IISEL 
THE SUB-KEYWORDS TO BY WHILE ANO UNTIL ARE RESERVED WITHIN A 
INSTRUCTION, IE THEY CANNOT NAME VARIABLES IN THE EXPRESSI ON(S) . 


TO WHOLE 


DO 


STATEMENTS TOGETHER AND 


THE DO INSTRUCTION IS USED TO GRUUP 
OPTIONALLY TO EXECUTE THEM REPETITIVELY. 

IF NEITHER "REPETITOR" NOR "CONDITIONAL" IS GIVEN, T HEN THE 
CONSTRUCT MERELY GROUPS A NUMBER OF INSTRUCTIONS TOGETHER: THESE ARE 
EXECUTED ONCE. 

OTHERWISE THE INSTRUCTION-LIST IS EXECUTED ACCORDING TO THE 
REPETITOR PHRASE, OPTIONALLY MODIFIED BY THE CONDITIONAL PHRASE: 

IF NO REPETITOR IS GIVEN (SO THERE IS ONLY A CONDITIONAL, SEE 
BELOW), THEN THE INSTRUCTION-LIST WILL NOMINALLY BE EXECUTED 
INDEFINITELY IE. UNTIL THE CONDITION IS SATISFIED. 

IN THE SIMPLE FORM OF THE REPETITOR, THE EXPRESSION "EXPRR" IS 
EVALUATED IMMEDIATELY (RESULTING IN A NUMBER WHICH IS NOT NEGATIVE AND 
is a whole number), and the loop is then executed that many times (which 

MAY BE 0). NOTE THAT, SIMILAR TO THE DIFFERENCE BETWEEN A COMMAND AND 
THE ASSIGNMENT STATEMENT, IF THE FIRST TOKEN OF "EXPRR" IS A SYMBOL AND 
BE^EXPECTED- 01 ^ 1 '* iS AN , = *’ THt|Nj THE CONTROLLED FORM OF REPETITOR WILL 

THE CONTROLLED FORM SPECIFIES A CONTROL VARIABLE, "NAME", WHICH IS 
GIVEN AN INITIAL VALUE (THE RESULT OF "EXPRI"), AND WHICH IS THEN 
STEPPED (BY ADDING THE RESULT OF "EXPRB") EACH TIME THE INSTRUCTION-LIST 
IS EXECUTED, WHILE THt END CONDITION THE RESmT OF "EXPRT") IS NOT 
EXCEEDED. IF "EXPRB" IS POSITIVE, THEN lie lSoP wIlL BE TERMINATED WHEN 
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terminated £SEilS A J^\s"g;r;A A n X L NdGATIve ’ THEN 

"EXPRI", "EXPRT..: *J„ .*5:L™ AN "EXPRT- 


26. 


the 


loop will Bg 


IN ^-gfWSS 
<«:■ SW&,&- LL EXECu ^ 

NOTE THAT THE VARIA3LE »NAM?M D r TI ° N T6RMINATtS JIuiN THE L00p » A N0 
this may affect iJ A ,T?? LE Tt NAMt CA, ' f BE altered within ^ lu£ uf ^ 

CONTROL VAR I Ab L c WHlf^TN^nP UF TH£ L00P ' ALTERING THE lD£RED Gqq E 

programming practice ^n , i TT A L00p Is mr NOKMA tatn ciKCUtf STA N c Es. 

ALI1LE, TnOJbh IT MAY BE USEFUL IN CERTAIN Li 

'Somonis '^STrfi-iSSsS 

■SS E b UTE 2 ‘ y- ' = ° &*Si F fSj ^ SSI5SS 0 "™ “S h |? t £ 

25.* li. i' T ; fc IN SIRUC T ION—L IS T WILL St REPE»T£OL» £« Cl,Ttl D E11*, 
i le The result is • i*» or until the result is *i *, 

INSTR^t?, ‘r HlLE ’ L00P ’ THE CONDITION IS EVALUATED AT THE TOP OF THE 
THF T S« N , L ST ’ AN0 hDR AN 'UNTIL' LOUP THE CONDITION IS EVALUATtD AT 
THE BOTTOM (AFTER THE VARIABLE "NAME" HaS BEEN STEPPED, IF APPROPRIATE). 

TLJ _ [ g0TE THAT EXECUTION OF a CONTROLLED LOOP MAY BE MODIFIED BY USING 
THE LtAVE OR ITERATE STATEMENTS. 

PRflk&AMMER'S MODEL = auii A TYPICAL DO lQQP IL EXECUTED : 

FOR THE FOLLOWING DO: 

DO NAME =EX PR I TO EXPRT BY EXPRB WHILE EXPRW 
INSTRUCT I UN—L1ST 
END 

REX WILL EXECUTE THE FOLLOWING: 

NAM6=EXPRI 
£TEMPT=EXPRT 
£TEMPB=EXPRB 
£LOOP: 

If -ex"» R n t„ T e E n P L T vs N LEAVE /A LEAVE ntANS ,0UIT ™ E LOOP. ., 
INSTRUCTION-LIST 
NAME=NAME + £TEMPB 

/ * UNTIL EXPRESSION WUULD HAVE BEEN TESTED HERE TF ncnrs 
TRANSFER CONTROL TO LABEL £LOOP * USED %/ 

NOTE: THIS EXAMPLE IS FOR EXPRB >= Q. FOR NEGATIVE EXPftB r 

AT THE START OF THE LOOP WOULD BE < RATHER THAN >* 8 ’ THE TEST 


/* £VAR TABLES ARE INTERNAL AND NOT ACCESSIBLE */ 
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REX 


a-t.5. asiip 


fl If V»»» II19 it IR S» II 19 II IIII II (I 19 


...„„,m a 

I 

WHERE VARIABLE-LIST IS A LIST OF SYMBOLS SEPARATED BY BLANKS. I 


i DROP <VARIABLE—LIST>; 


tt II VI II n II II19 fl 19 >9 II II II ft il II If (I •• 


II lilt nil II Bffli 

EACH VARIABLE IN THE LIST WILL BE DROPPED FROM THE LIST OF KNOWN 
VARIABLES. IT IS NOT AN ERROR TO SPECIFY A NAME MORE THAN ONCE, OR TO 
•DROP' A VARIABLE THAT IS NOT KNOWN. IN EITHER OF THESE CASES THE NAME 
IS IGNORED. 

IF NO LIST IS SPECIFIED, THEN ALL KNOWN VARIABLES WILL BE DROPPED. 


2.-6..L LALI 

^minimum, IIIIIIII I> IIIIII null n n mill imnn it iiiih iiiiii n»n *»» mum "" 11 *• """" M mi n iiiiin, m, nunmi ng 

I EXIT <EXPRESSION>; I 

n n n mm mi mi n ii n mi u n nn i, nmill iiH nn » mm mm 11,11111 " " " "" " ,MI " " 11 "" 11 nniin nn nn mi n n^ 

THE EXPRESSION IS CONVERTED TD A NUMBER, WHICH MUST BE A WHOLE 
NUMBER (IE THE DcCIMAL PART, IF ANY, MUST BE C), AND EXECUTION IS 
TERMINATED WITH THE NUMBER BElNG USED TO SET THE RETURNCODE. IF NO 
EXPRESSION IS GIVEN, ThE RETURNCODE WILL BE SET TO C. 

NOTE THAT "RUNNING OFF THE END" OF THE PROGRAM IS EQUIVALENT TO THE 
INSTRUCTION "EXIT 0". 


;gn ii n n ii n mi inn, nniin niinii nn min tint, minim minim n in, it nun nn tut im nn iiiinii nun min nn mi n ny 

I IF EXPRESSION THEN INSTRUCTION <ELSE < ;> INSTRUCTI0N>; | 

i ; I 

n n mill i, nn ii nn un nnu n f. 


THE EXPRESSION IS EVALUATED AND MUST RESULT IN '0* OR 'l*. THE 
FIRST INSTRUCTION IS EXECUTED ONLY IF THE RESULT WAS • 1 •. IF AN ELSE 
WAS GIVEN, THEN THE INSTRUCTION AFTER THE ELSE IS EXECUTED ONLY IF THE 
RESULT WAS *0‘. 

THE SPECIAL KEYWORD 'THEN' MaY FOR CONVENIENCE BE USED TO TERMINATE 
THE IF CLAUSE, OR IS LEGAL AS A CLAUSF IN ITS OWN RIGHT. IN B0TH THESE 
CASES IT IS SYNONYMOUS WITH THE SEPARATOR CHARACTER <;) AND IS THEREFORE 
IGNORED AND SO MAY Bt USED FOR IMPROVED READABILITY. HENCE A VARIABLE 
CALLED "THEN" CANNOT BE USED WITHIN THE EXPRESSION. 


NOTE THAT AN "INSTRUCTION" 
CONSTRUCTIONS SUCH AS DO GROUPS, 
"IF" INSTRUCTION ITSELF. 


INCLUDES 
AS WELL AS 


ALL THE MORE COMPLEX 
THE SIMPLER ONES AND THE 
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- a.fe.fi II£MI£ 


I ITERATt <SYMBGL>; """"'"'tf 

.. iOOP WHICH Tr 

ITERATE ALTERS THE PLOW WITHIN A CUNTRCJLLED DO LOOP ‘ TO 1 a\ 

REPEATED UNDER THE CONTROL OE A VARIABLE - EG: D °p! S SEO BACK UP 

EXECUTION OF THE INSTRUCTION LIST STOPS, AND CONTROL 1$ Pi ENCOUNTERS* 
TO THE DO CLAUSE JUST AS THOUGH THE END CLAUSE HAD BEEN J ^ u 
THE CONTROL VARIABLE IS THEN STEPPED (ITERATED) AS NORMA ME 

CLAUS£ CTIUN Li5T EXECUTED AGAIN UNLESS THE LOOP IS TERMINATED 00 

IF NO SYMBOL IS SPECIFIED, THEN 

ACTIVE CONTROLLtD LOOP. IF a SYMBOL IS SPECIFIED, inc *• M . v ~ 

NAME OF THE CONTRUL VARIABLE OF A CURRENTLY ACTIVE LOOP (WHICH MAYBE 
THE INNERMOST), AND THIS IS THE LOOP THaT IS STEPPEO. ANY ACTIVE LOOPS 
INSIDE THE ONE SELECTED FOR ITERATION ARE TERMINATED (AS THOUGH BY a 
LEAVE INSTRUCTION). 

tiQILS. : A LOOP IS ACTIVE IF IT IS CURRENTLY BEING EXECUTED. IF a 
SUBROUTINE IS CALLED (OR a “REX" INSTRUCTION IS EXECUTED) DURING 
EXECUTION OF A LOUP, THEN ThE LOuP BECOMES INACTIVE UNTIL THE SUBROUTINE 
HAS RETURNED OR THE WnOLE STRING HAS BEEN INTERPRETED. 

IF MORE THAN ONE ACTIVE LOOP USES THE SAME CONTROL VARImBLE ( ) 
THEN THE INNERMOST WILL BE THE ONE StltrCTED BY THE ITERATE. 


TERATE WILL STEPI^MUS ^B^ThF 

SPECIEIED, THEN IT JUST BE T 



# 











D 

% 

H 
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LEAVE 


I LEAVE <SYMBOL>; 


I 


LEAVE CAUSES IMMEDIATE EXIT FROM ONE UR MORE CONTROLLED rn , nr.PS 
(LOOPS WHICH ARE REPEATED UNDER THE CONTROL OF A VARIABLE - EG- mT-i 
TO 10). EXECUTION OF THE INSTRUCTION LIST IS TERMINATED, AND cniuruni IS 
PASSED TO THE INSTRUCTION FOLLOWING THE END CLAUSE, JUST as THTur h ThE 
END CLAUSE HAD BEEN ENCOUNTERED AND THE TERMINATION CONDITION had BEEN 
MET NORMALLY, EXCEPT THAT ON EXIT THE CONTROL VARIABLE WILL contain 
VALUE IT HAD WHEN THE LEAVE INSTRUCTION WAS EXECUTED. 

IF NO SYMBOL IS SPECIFIED, THEN LEAVE WILL TERMINATE THE INNERMOST 
ACTIVE CONTROLLED LOOP. IF A SYMBOL IS SPtCIFlED, THEN IT MUST HE THE 
NAME OF THE CONTROL VARIABLE OF A CURRENTLY ACTIVE LOOP (WHICh MAY BE 
THE INNERMOST), AND THAT LOOP (AND ANY ACTIVE LOOPS INSIDE IT) is THEN 
TERMINATED. CONTROL THEN PASSES TO THE CLAUSE FOLLOWING THE END THAT 
MATCHES THE DO CLAUSE OF THE SELECTED LOOP. 

NOTES : A LOOP IS ACTIVE IF IT IS CURRcNTLY BEING EXECUTED IF A 

SUBROUTINE IS CALLED (OR A ••REX" INSTRUCTION IS EXECUTED)’ DURING 
. EXECUTION OF A LOOP, THEN THE LOOP BECOMES INACTIVE UNTIL THE SUBROUTINE 
HAS RETURNED OR THE WHOLE STRING HAS BEEN INTERPRETED. 

IF MORE THAN ONE ACTIVE LOOP USES TmE SAME CONTROL VARIABLE ( ) 
THEN THE INNERMOST WILL BE THE ONE SELECTED BY THE LEAVE. 


NOP IS A DUMMY INSTRUCTION WHICH HAS NO EFFECT. 
THE TARGET OF AN ELSE, WHEN, OR THEN CLAUSE: EG: 


IT CAN BE USEFUL AS 


SELECT 

WHEN A=B THEN NOP /* 
WHEN A>6 THEN SAY 'A 
OTHERWISE SAY »A 
ENO 


DO NOTHING */ 
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parse arcs <template>; 
parse pull <template>; 

PARSE VAR NAME <TEMPLaTE>* 

WHERE "TEMPLATE" IS A LIST OF SYMBOLS SEPARATED BY BLANKS AND/CR j 
"TRIGGERS" (SPECIAL CHARACTERS OR STRINGS). „ it •••• ""itnim ■ 


THE PARSF INSTRUCTION IS USED TO PARSE DATA WITHOUT TRANSLATION OF 
WORDS TO UPPER CASE. THE TEMPLATE IS USEU TO PARSE THE DATA FOLLOWING 
THE SAME RULES AS FOR THE PULL INSTRUCTION (U.V.), EXCEPT FOR THt LACl < 
OF TRANSLATION. 

THE DATA USED FOR t ACH VARIANT OF THt PARSE INSTRUCTION IS-' 

FOR PARSE ARGS: ThE STRING PASSED TO THE PROGRAM OR SUBROUTINE AS AN 
INPUT PARAMETER LIST IS USED. ISEE UNDER THE ARGS INSTRUCTION FDR 
DETAILS) 

FOR PARSE PULL: THE NEXT LINE FROM THE STACK. (OR FAILING THAT FROM A 
CONSOLE READ) IS USED. (SEE ALSO THE PULL INSTRUCTION) 

FOR PARSE VAR NAME: THE VALUE OF THE VARIABLE SPECIFIED BY "NAME" IS 


1.6.12 PROCEDURE. 


37 II It until! "" ..H " «« 

1 PROCEDURE; 



THE PROCEDURE STATEMENT MAY BE USED WITHIN A SUBROUTINE TO PROTECT 
THE EXISTING VARIABLES BY MAKING THEM UNKNOWN TO FOLLOWING INSTRUCTIONS. 
ON EXECUTING A RETURN STATEMENT* THE ORIGINAL VARIABLES are RESTORED' 
AND ALL THOSE USED LOCALLY WITHIN THE SUBROUTINE ARE DROPPED. 

A SUBROUTINE NEED NOT INCLUDE A PROCEDURE STATEMENT * in WHICH CASE 
THE VARIABLES IT IS MANIPULATING ARt THOSE 'OWNED' BY THE CALLER 

ONLY ONE PROCEDURE STATEMENT IN EACH LEVEL OF SUBROUTINE VaIL lS 
ALLOWED, ALL OTHERS (AND THOSE MET OUTSIDE SUBROUTINES) ARE In ERROR 


THE PROCEDURE STATEMENT NEED NOT BE THE FIRST INSTRUCTION 
AFTER THE CALL: PREVIOUS INSTRUCTIONS WILL ACCESS THE CURRENT 
VARIABLES. . - . . 


executed 
LEVEL OF 
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1.6.11 EULL 


S'""""" 

| PULL <TEMPLATE>; 

I 

i WHERE '‘TEMPLATE" IS 
| "TRIGGERS" (SPECIAL 


I 

A LIST OF SYMBOLS SEPARATED BY BLANKS AND/OR i 
Ct i ARACTERS ( or ^STRINGS) . ^ ^ _ ^ ^ | 


THE CURRENT HEaD-OF-QUEUE WILL BE READ 
IMPLEMENTATION, THE CONSOLE INPUT "S lACK" 
IN THE STACK THEN A CONSOLE READ WILL 
SPECIFIED, NO FURTHER ACTION IS TAKtN• 


AS ONE STRING. I N TH g CMS 
IS USED: if There is nothing 
OCCUR. IF NO TEMPLATE IS 


GENER AL RULES OF PARS ING: (THE REST OF THIS SECTION APPLIES ALSO TO THE 
ARGS AND PARSE INSTRUCTIONS). 

THE INPUT DATA STRING WILL BE PARSED ACCORDING TO THE RULES DEFINED 
BELOW, AND WORDS (GROUPS OF CHARACTERS DELIMITED BY BLANKS) ARE ASSIGNED 
TO THE TEMPLATE SYMBOLS IN SEQUENCE. FOk THE PULL AND ARGS INSTRUCTIONS 
THE WORDS ARE TRANSLATED TO UPPERCASE FIRST. (USE THE PARSE INSTRUCTION 
IF THIS IS NOT DESIRED). 

UNLESS THERE ARE FEWER WORDS IN THE INPUT STRING THAN SYMBOLS IN THE 
TEMPLATE, The FINAL SYMBOL WILL have THE REMAINDER OF THE INPUT LINE 
ASSIGNED TO IT AS A SINGLE UNEDITED STRING. THUS IN THE LIMITING CASE 

of there only being one symbol specified, it will be assigned the entire 
INPUT STRING. 

IF YOU ARE INTERESTED IN FEWER WORDS THAN EXIST IN THE STRING, THEN 
YOU WILL WANT TO ADD A DUMMY VARIABLE TO THE END OF THE TEMPLATE (TO 
AVOID THE FINAL VARIABLE BEING ASSIGNED MULTIPLE WORDS). 

ALL SYMBOLS IN ThE TEMPLATE WILL BE GIVEN A NEW VALUE, AND ARE 
THEREBY CONTEXTUALLY DECLARED AS VARIABLES. (IF THERE ARE MOKE SYMBOLS 
THAN WORDS IN THE DATA, THEN THE EXTRA VARIABLES WILL BE ASSIGNED THE 
NULL STRING.) 

THE VALUES ASSIGNED TO EACH VARIABLE MAY BE INSPECTED DURING PROGRAM 
DEBUG BY USING THE "TRACE RESULTS" INSTRUCTION (O.V.). 
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SIMPLE PARSIN G (NO TRIGGERS IN THE TEMPLATE): 


FOR EACH VARIABLE EXCEPT THE FINAL QNF IN THE I ’ ' EACH 
line IS SCANNED FOR "WORDS” (IE, CONTIGUOUS NOn-blANK ^TRANSLATED 
WORD (TRANSLATED TO UPPER CASE FOR Pu LL AND ARCS OR LIST - 

™ e to l ;s kk ,HE INPUI 


the INPUT 


— » 45s,gned t " e Tssrsi 1 *."^ 


IF HOWEVER 


there is MORE THAN 0 
IGNED A VALUE ' J 

WHICH WILL NEVER HAVE LEADING BLANKS 


T.Lurw„ic"‘ 25 blanks but 


DATA ON THE STACK: 
INSTRUCTION: 
RESULTS IN: 


'FRED PLEASE TALK TO ME * 
"PULL NAME REST" 

"NAME" HAS THE VALUE 'FRED' 
"REST" HAS THE VALUE • PLEASE 


TALK TO ME 


THEN THE INSTRUCTION: "PARSE VAR REST WRD1 WRD2 REST" 


RESULTS IN: 


"WRD1" HAS THE VALUE ‘PLEASE 1 

"wrd2“ has the value ‘talk* 

"REST" HAS THE VALUE 'TO ME ' 
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S * 

parsing WIIH triggers : 


REX ALLOWS SIMPLE PATTERN MATCHING USING TRIGGERS (ANY SPECIAL 
CHARACTER OR STRING) IN ThE TEMPLATE. c vm nm c 

TRIGGERS IN THE TEMPLATE CAUSE THE LI ST ^ A STRtk 6 SEPARATED 

# : 

1 

INTO GROUPS, EACH OP WHICH IS MATCHED AbAlNbl A STRl NG 0( _ daTA 
CHARACTERS WHICH IS THEN PARSED IN THE SAMt , W f X , vmr “ CR Ib E0 ABOVE FOR 
•SIMPLE PARSING* (1.6. IE THERE IS MORE T " AN °NE Al -L EXCEPT THE 

LAST ARE ASSIGNED INDIVIDUAL WORDS, AND THE FINAL ONfc WILL GET THE DATA 

"i 1F - 

REMAINING) . I1TI , r«,,c c T 

THE PRESENCE OF A TRIGGER IN THE TEMPLATE WILL CAUSE THE Data STRING 
TO BE FORWARD SCANNED FOR THAT TRIGGER. THE DATA iUP TO THE TRIGGER IS 
THEN USED FOR PARSING AGAINST THE CURRENT GROUP OF TEMPLATE SYMBOLS, OR 
IF THE TRIGGER IS NOT FOUND, ALL THE A ™ SYMBOLS* lT 

• 

ONCE data IS PARStD AND ASSIGNED TO A oKUUK u r 5Y n BULS, i T ( aND THE 
TRIGGER CHARACTER!S) ) IS SKIPPED OVER AND MATCHtO AbAINST ThE NEXT GROUP 
OF SYMBOLS IN THE TEMPLATE (UP TO THE Nt XT TRIgGcR OR THE END OF THE 

• 

TEMPLATu). DATA IS THEREFORE NEVER SCANNED MORE THAN ONCfc DURING 

PARSING. 

• 

EXAMPLE 1 (SINGLE SPECIAL CHARACTER TRIGGER): 

DATA ON THE STACK: 'FRED WAS HEkE (I THINK)* 

• 

RESULTS IN: "NAME" HAS THE VALUE 'FRED* 

* 

32 gTi- 

"MORE" HAS THE VALUE 'I THINK)* 


EXAMPLE 2 (ONE STRING AND ONE SPECIAL CHARACTER TRIGGER): 

36^:; 

m 

3y* 

THE ARGUMENT STRING: 'SEND FRED TO THERE (PLEASE* 

INSTRUCTION: "ARGS NAME1 NAME 2 • TO • PLACE ( MORE" 

RESULTS IN: "NAME 1" HaS THE VALUE 'FRED* 

"NAME2" HAS THE VALUE " 

* - 

"PLACE" HAS THE VALUE 'THERE* 

"MORE" HAS THE VALUE 'PLEASE* 

• 


« 

■■■■ . v .. ■ . ■ ■ 
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ii „ M it it"" 


I PUSH <EXPRLSSION> 5 .. 

cn iiFO (LAST IN, 

THE STRING RESULTING FROM EXPRESSION WILL BE STACKER >- jS STACKED. 
EIRST OUT). IE NO EXPRESSION IS SPECIFIED, THE NULL STR1" 

IN THE CMS IMPLEMENTATION, THE CONSOLE INPUT STACK IS USED. 


a.&.ii au£u& 


I QUEUE <EXPRES S10N> i ,,,,,,,, 1.1 "" '•«# 

THE STRING RESULTING FROM EXPRESSION WILL BE "S f ACKED" 

-IN, FIRST OUT). IF NO EXPRESSION IS SPECIFIED, THE NULL S'K^ND IS 
QUEUED. IN THE CMS IMPLEMENTATION, THE CONSOLE INPUT STACK IS USED. 


3 .6.16 s.Lnm 

* •—"»•••• .. . 

I RETURN <EXPRESSION>; 


IF A SUBROUTINE IS BEING EXECUTED (SEE THE CALL INSTRUCTION) THEN 
THE EXPRESSION IS EVALUATED, AND THE VARIABLE SPECIFIED BY THE 
SUBROUTINE NAME IS SET TO THE RESULT. (I.E, IF THE SUBROUTINE WAS 
CALLED "FRED", THEN TmE VARIABLE "FRED" WOULD BE SET). IF NO EXPRESSION 
IS SPECIFIED, THEN THE VARIABLE IS SET TO NULL. 

ONCE THE VARIABLE "HAS BEEN SET, CUNTRUL RETURNS TO THE CLAUSE 
FOLLOWING THE CALL INSTRUCTION, AND THE VARI ASLE-"SIGL" IS SET TO THE 
LINE NUMBER OF THE RETURN INSTRUCTION JUST EXECUTED. 

IF A PROCEDURE STATEMENT WAS EXECUTED WITHIN THE SUBROUTINE., THEN 
THE LOCAL VARIABLES ARE DROPPED (AND THE OLD ONES RESTORED) AFTER THE 
EXPRESSION EVALUATION AND BEFORE THt RESULT IS ASSIGNED TO THE RETURN 
VARIABLE. 

IF NO SUBROUTINE IS BEING EXECUTED, THEN RETURN WILL CAUSE CONTROL 
TO LEAVE THE PROGRAM: THE RESUlT OF THE EXPRESSION IS PUSHED ONTO THE 
STACK, AND EXECUTION IS TERMINATED WITH RETURNCODE SET TO ZERO IF NO 
EXPRESSION IS GIVEN, THE NULL STRING WILL BE PUSHED ONTO THE STACK. 
NOTE : IF The REX PROGRAM hAS BEEN CALLED (BY REX) AS A FUNCTION THEN 
THE RETURN STATEMENT WILL AUTOMATICALLY USE THE DIRECT METHOD QF PASSING 
BACK DATA DESCRIBED ELSEWHERE. IN THIS CASE, THERE IS NO RESTRICTION ON 
THE LENGTH OR CONTENT OF THE DAT A; AND NOTHING IS PLACED ON THE ^TaCK. 
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WILL THEN BE EXECUTED < t MTl , Tcn i 

A LINE INSERTED 

ANY INSTRUCTIONS I INClSo™! "S" 


THE EXPRESSION IS EVALUATED, AND WI 
JUST AS THOUGH THE RESULTING SIRING WER 

FILE BRACKETED BY A DU AND AN END. Al.. UNtU 

INSTRUCTIONS) ARE ALLOWED, Bui NOTc THAT CONSTRUCTIONS SUCH 
FND. SELECT ... END MUST BE COMPLETE. 

A SEMICOLON IS IMPLIED AT THE END OF THE EXPR£$ Siqn 
EXECUTION, AS A SERVICE TO THE USER. 

IF NO EXPRESSION IS SPECIFIED 
REX MODULE WILL BE DISPLAYED. 


during 


THE VERSION NUMBER AND DATE OF THE 


MQIE.: LABELS WIThIN THE INTERPRETED STRING ARE NOT PERSISTENT AND ARE 
THEREFORE IGNORED. HENCE EXECUTING A SIGNAL INSTRUCTION FkOM WITHIN AN 
INTERPRETED STRING WILL CAUSE IMMEDIATE cXIT FROM THAT STRING beFORE THE 
LABEL SEARCH BEGINS. 


2.6.18 S.AY 

. . . ""'"•••.... 

I SAY EXPRESSIONS; 



THE STRING RESULTING FROM EXPRESSION IS DISPLAYED (OR SPOKEN, OR 

typed,, etc.) to the user via whatever Channel is implemented. any 

LENGTH STRING IS PERMITTED,-. 

NOTE : IN THE CMS IMPLEMENTATION, THE DATA WILL BE FORMATTED WITH 60 

CHARACTERS PER LINE. CONTINUATION LINES WILL THEN BE UP TO 79 
CHARACTERS LONG; PRECEDED BY A SINGLE BYTE X 1 FF • . THIS ALLOWS PROGRAMS 
WHICH CAPTURE AND PROCESS THE OUTPUT FROM A REX PROGRAM TO RE-CREATE ThE 
ORIGINAL FORMAT OF THE DATA WITHOUT LOSS OF INFORMATION. LINES ARE 
TYPED ON A TYPEWRITER TERMINAL, UR .•DISPLAYED' ON A VDU. 
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1.6.19 SELECT 


select; when-list cotherwise <;> <INSTRUCTIDN-LIST» 


end; 


is: one DR MORE WHEN-CONSTRUCT oN 
is: WHEN EXPRESSION THEN INSTRUB 

AND INSTRUCTION-LIST IS ANY SEQUENCE OF INSTRUCTIONS 


WHERE WHEN-LIST 
AND WHEN-CONSTRUCT 


turn and must 

EACH EXPRESSION FOLLOWING A WHEN IS EVALUATED IN INSTRUCTION) 

RESULT IN '0* OR •1*. IF THE RESULT IS 'IS THE FOLLOW! SELECT) k 

(WHICH MAY BE A COMPLEX INSTRUCTION SUCH AS IF, DO, “ quNTKOL WILL 
EXECUTED AND CONTROL WILL THEN PASS TO THE END. OTHERWISE 
PASS TO THE NEXT WHEN STATEMENT. 


IF NONE OF THE WHEN EXPRESSIONS SUCCEED, 
INSTRUCTION-LIST (IF ANY) FOLLOWING OTHERWISE 
ABSENCE OF AN OTHERWISE WILL CAuSE AN ERROk. 


rriMToni WILL PASS TO THE 
C0NTR ° L .„ cttUATION, THf 


THE SPECIAL KEYWORD 'ThEN* MAY FOR CONVENIENCE BE USED T0 TERMINATE 
A WHEN CLAUSE, OR IS LEGAL AS A CLAUSE IN I fS OWN RIGHT. 'V't ccccod 
CASES IT IS SYNONYMOUS WITH THE SEPARATOR CHARACTER (5) AND IS THtKtFJRE 
IGNORED AND SO MAY BE USED FOR IMPROVED READABILITY. A VARIABLE CALLEO 
"THEN" CANNOT THEREFORE BE USED WITHIN THE EXPRESSION IN A 
WHEN-CONSTRUCT. 
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1.6.£2. S IGNAL Aim LMLLLS. 

V ",mm 

| SIGNAL EXPRESSION; 

| SIGNAL ON EXPRESSION; 
| SIGNAL OFF expression; 



THE SIGNAL INSTRUCTION CAUSES AN A&jQlML CHANGE IN THE FLOW OF 
CONTROL* OR (IF ON OR OFF IS SPECIFIED) CONTROLS EXCEPTION HANDLING. 


IN THE CASE OF NEITHER ON NOR OFF BEING SPECIFIED: 

THE EXPRESSION IS EVALUATED, AND TAKEN TO BE THE NAME OF A LABEL. 
ALL PEN0IN6 LOOPS. ■•REX” INSTRUCTIONS, ETC. ARE THEN TERMINATED 
(I.E. THEY CANNOT BE REACTIVATED). IF THE LABEL IS KNOWN TO THE 
INTERPRETER (OUE TO ITS BEING SIGNALED OK CALLED BEFORE) THEN 
CONTROL WILL IMMEDIATELY BE PASSED TO THE CLAUSE FOLLOWING THE 
LABEL. OTHERWISE, A SEARCH IS MADE FOR THE LABEL: The SEARCH 
PROGRESSES FROM THE TOP OF THE DATA THROUGH THE END OP THE DATA, 
WITH ALL THE DATA BEING SCANNED (REGARDLESS OF ANY FLOW CONTROL 
STATEMENTS). NOTE THAT SINCE REX 'REMEMBERS* LABELS, CONTROL WILL 
ALWAYS PASS TO THE FIRST ONE IN THE DATA IF DUPLICATES ARE PRESENT. 
(I.E, DUPLICATE LABELS ARE IGNORED). 


IN THE CASE OF ON OR OFF BEING SPECIFIED: 

THE EXPRESSION MUST EVALUATE TO ONE OF THE THREE BUILT-IN 
CONDIT1UNS: 


ERROR - RAISED IF ANY HOST COMMAND RETURNS A NON-ZERO RETURNCCDE. 

exit - raised if any exit (but not return) instruction is 
executed. 

syntax - RAISED IF ANY INTERPRETA I1UN ERROR IS DETECTED. 


IF ON IS SPECIFIED, THE GIVEN CONDITION IS ENABLED; AND IF OFF IS 
GIVEN, THE CONDITION IS DISABLED. THE INITIAL SETTING OF ALL 
CONDITIONS IS OFF. 

WHEN A CONDITION IS ENABLED AND TriE SPECIFIED EVENT OCCURS, ALL 
CURRENT EXECUTION WILL CEASE, AND A 'SIGNAL XXX* (WHERE XXX IS 
ERROR, EXIT, OR SYNTaX) IS EXECUTED AUTOMATICALLY. WHEN THE EVENT 
OCCURS, THE CONDITION WILL BE DISABLED IMMEDIATELY (BUT MAY BE 
RE-ENABLED IF DESIRtD). THEREFORE, IF THE LABEL IS NOT FOUND, A 
NORMAL SYNTAX ERROR EXIT WILL BE TAKEN. 


NOTE THAT IF A SIGNAL INSTRUCTION OR CONDITION IS ISSUED AS A RESULT 
OF A REX INSTRUCTION, THE REMAINDER OF THE STRING(S) BEING INTERPRETED 
WILL NOT BE SEARCHED FOR THE GIVEN LABEL. IN EFFECT, LABELS WITHIN 
INTERPRETED STRINGS ARE IGNORED. 

LABELS ARE SINGLE SYMbOLS OF UP TO 150 CHARACTERS, FOLLOWED BY A 
COLON. THE COLON ACTS AS A CLAUSE SEPARATOR, AND SO A LABEL IS A CLAUSE 
IN ITS OWN RIGHT AND MULTIPLE LABELS MAY THEREFORE PRECEDE AN EXECUTABLE 
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™ Ll0WING Th£ EXECUTION OF any jump DUE TO A S Iu£ BUI L 

& s i 5 S”° r™ 

S.oI H »N N 6S!m. OF . TH6 UN6 ^« c « 6tU ’ 
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n 

o 
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; LINE NUMBER 
-IN VARIABLE 
(SEE ABOVE) 

EXAMPLE» TO 
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2.6.£L IRACJI 


I TRACE EXPRESSIONS; I 

TRACE WILL EVALUA1E THE EXPRESSION, AND TAKE ACTION ACCORDING TO ThE 
FIRST CHARACTER OF THE RESULT: 

•c» (P.G: "ERROR”) - HOST COMMANDS RESULTING IN NON-C 

RETURNCODE ARE TRACED (AFTER EXECUTION) 

•C* (E.G: "COMMANDS") - AlL HOST COMMANDS ARE TRACED BEFGRg 
EXECUTION! AND NON-ZERO RC IS SHOWN 

•A* (E.G* "ALL") - ALL CLAUSES ARE TRACED BEFORE EXECUTION 

•R* (E.G: "RESULTS") - ALL CLAUSES ARE TRACED BEFORE EXECUTION 

TOGETHER WITH THE FINAL RESULT OF ANY 
EXPRESSION EVALUATED. VALUES ASSIGNED 
DURING PULL, ARGS AND PARSE INSTRUCTIONS 
ARE ALSO DISPLAYED. 

•I* (E.G: "INTS") - AS 'R* EXCEPT THAT ALL TERMS AND INTERMED¬ 

IATE RESULTS DURING EXPRESSION EVALUATION 
(AND SUBSTITUTED NAMES) ARE ALSO TRACED. 

•S' (E.G: "SCAN") - ALL REMAIN I No CLAUSES IN THE DATA WILL BE 

TRACED WITHOUT BEING EXECUTED. BASIC 
CHECKING (FOR MISSING END'S ETC) IS CARRIED 
OUT, AND THE TRACE IS FORMATTED AS USUAL. 
THIS ONLY HAS EFFECT IF ThE "TRACE SC«N» 
CLAUSE IS NOT ITSELF NESTED IN ANY OTHER 
INSTRUCTION. 

•O’ (E.G: "OFF") - NOTHING IS TRACED 

(OTHER FIRST CHARACTERS WILL CAUSE AN tRROR) 

ANY OF THESE OPTIONS MAY BE PREFIXED WITH THE CHARACTER * ', WHICH 
HAS THE EFFECT OF INHIBITING COMMAND EXECUTION UNTIL THE NEXT TRACE 

COMMAND IS EXECUTED. THIS MAY BE USED FOR DEBUGGING POTENTIALLY 

DESTRUCTIVE PROGRAMS. FOR EXAMPLE, "TRACE COMMANDS" WILL CAUSE 

COMMANDS TO BE TRACED BUT NOT EXECUTED. IN THIS CASE, RC IS SET TO 'O' 

AS EACH COMMAND IS BYPASSED. 

COMMANDS TRACED BEFORE EXECUTION ALWAYS HAVE THE VALUE OF THE 
COMMAND TRACED AS WELL AS THE CLAUSE CAUSING IT. 

EACH CLAUSE TRACED WILL BE DISPLAYED WITH AUTOMATIC FORMATTING 
(INDENTATION) ACCORDING TO ITS LOGICAL DEPTH OF NESTING ETC. RESULTS 
(IF REQUESTED) ARE INDENTED AN EXTRA TWO SPACES. 

THE FIRST CLAUSE TRACED ON ANY LINE WILL HAVE ITS LINE NUMBER 

PREFIXED. 


O 

f) 

n 

O 

r 

r 
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r 
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r 

r 
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r 
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DDC r^T EPT F0R " t *ACE SCAN", CLAUSES ARE IDENTIFIED -- r 
rRtLtDING •*-*• TAG, AND RESULTS ARE IDENTIFIED BY A TAG 
FOLLOWING a SYNTAX ERROR, THE STATEMENT IN ERRO r 
TRACED, AS WILL ANY CALL OR REX STATEMENTS ACTIVE AT TH 

error, these traceback lines are identified by the sp£ cIAU 


T Mf, T raC1N& BY, A 
DU r * N L •»>*. 


the; 


A 
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2-2 FUNCTIONS AND SUlLIisLN VARIABLES. 

SINCE REX CAN INCLUDE EXTERNAL FUNCTION CALLS 
EXPRESSIONS, 'NO BUILT-IN FUNCTIONS, HAVE BEEN IMPLEMENTED. 

A REFERENCE TO A CMS MODULE, NUCX, OR ANOTHER REX EXEC MAY BE 
INCLUDED IN AN EXPRESSION USING THE CONVENTIONAL PARENTHESES NOTATION. 
NOTE THAT THE NAME OF THE FUNCTION MUST BE ADJACENT 10 THE vjitH NO 

BLANK IN BETWEEN, OR THERE WILL BE A "BLANK OPERATOR" ASSUMED AT THIS 
POINT AND THE CONSTRUCT WILL NOT BE RECOGNISED AS A FUNCTION CALL 

EACH ARGUMENT EXPRESSION (SEPARATED BY COMMAS) IS EVALUATED, a.ND THE 
FUNCTION IS EXPECTED TO RETURN A RESULT IN AN ALLOCATED STORAGE BLOCK 
(SEE ELSEWHERE FOR DETAILS). IF THE FUNCTION DETECTS an ERROR, IT 
SHOULD RETURN A NON-ZERO RETURNCODE (THE ACTUAL VALUE OF THIS is IGNORED 
BY REX). 

FOR EXAMPLE, THE FUNCTION SUBSTR IS INCLUDED IN THE REXFNS PACK (SEE 
BELOW) AND COULD BE USED aS: 


"A=SUBSTR(6,2,7) 

NOTE THAT THE SYMBUL BEFORE THE *(' MAY BE A VARIABLE, SO THE 
SEQUENCE: "S=SUBSTR; A=SIB,2,7)5" WOULD HAVE THE SAME RESULT AS THE 
EARLIER LINE. A LITERAL STRING, TOO, MaY BE USED TO HOLD THE FUNCTION 
NAME AND SO INVOKE THE FUNCTION. 

A FUNCTION MAY HAVE A VARIABLE NUMBER OF ARGUMENTS: ONLY THOSE 
REQUIRED NEED BE SPECIFIED. SUBSTR(ABCDEF,4 ) WOULD RETURN 'DEF * FOR 
EXAMPLE. 

OTHER REX EXEC'S MAY BE CALLED AS FUNCTIONS. E .G: 

SAY 'EXEC SWAP*(ABC OEF); /* SWAP SWAPS THE WORDS */ 

ONLY ONE PARAMETER STRING (UP TU 24D CHARACTERS) May BE INCLUDED 
BETWEEN THE PARENTHESES IN THIS CASE. THE RETURN INSTRUCTION THEN USES 
THE NORMAL REX FUNCTION INTERFACE (INSTEAD OF THE STACK) AND SO THERE IS 
NO RESTRICTION ON THE CONTENT OR LENGTH OF THE RETURNED CHARACTER 
STRING. 

AN EXEC CALLED AS A FUNCTION SHOULD NORMALLY TERMINATE WITH A RETURN 
STATEMENT, AS USE OF THE EXIT STATEMENT WILL CAUSE AN ERROR WHEN CONTROL 
IS RECEIVED BACK BY THE CALLER. 

BUILT-IN VARIABLES : 

THE VARIABLE "RC" IS EQUIVALENT TO A VARIABLE CONTAINING THE 
RETURNCODE FROM THE LAST EXECUTED HOST COMMAND (OR SUBCOMMAND). 
FOLLOW ING'A SIGNAL EVENT (EXIT, SYNTAX, OR ERROR) IT CONTAINS THE CODE 
APPROPRIATE TO THE EVENT, IE THE VALUE UN THE EXIT STATEMENT, THE SYNTAX 
ERROR NUMBER (1-99), OR THE COMMAND RETURNCODE. 

THE VARIABLE "SIGL" CONTAINS THE LINE NUMBER OF THE LAST STATEMENT 
•SIGNAL' JUMP (IE, A SIGNAL, CALL/RETURN, OR ERROR 


THAT CAUSED 
CONDITION). 

rue THES£ VA ' UAbLES HAVE AN INITIAL VALUE. THEY MAY B £ 

n ta L 1J0ST L1 ^ any other Variable, and they may be 
ACCESSED VIA THE DIRECT INTERFACE TO REX VARIABLES. 
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MUMocnr 7 ARI THM6TIC OPERATIONS IN Re x WILL INVOLVE ^arE^THEKEfSc 
D WI - r ^,.?| C1 -? A .L PART). ^PERAUoJ LL oJ StEG^ A Jf.SULT OE^ 
Dividf ?* t« imt *t- 1N AGGERS, AND IN PARTICULAR* THE 

HOWEVERrrm?’ ‘ E * G * " 3/2 " WILL RESULT IN 'l')* tI oNS* a ND $q 
REX iUnuu iD C Tn MAL NUMBERS ARE OFTEN USEFUL FOR CALCULA 
EX ALLOWS UP TO NINE DIGITS AFTER A DECIMAL POINT. 

T t -DMl H£ T PRECISln, ' i ° F A RESULT IS DETERMINED BY THE P RECl p T HE Samp 
TERMS INVOLVED IN THE COMPUTATION: THE RESULT IS GlVfcN £$ ^ 

PRECISION AS THE MOKE PRECISE OF THE TWO TERMS. ™ 

ILLUSTRATED BY SOME EXAMPLES: 


best 


"8/3" 
"8/3.C" 
"6/3.00" 
ETC. 


(INTEGER ARITHMETIC) 

(NOTE ROUND UP ON DIVIDE) 


THIS MECHANISM ALLOWS REX TO EVALUATE INTEGER ARITHMETIC VERY 
EFFICIENTLY, AND AT THE SAME TIME PROVIDE A USEFUL DECIMAL ARITHMETIC 
FACILITY. 

(NOTE: IN THE CURRENT IMPLEMENTATION A DIVISION BY A NUMBER WITH 
MORE THAN 9 SIGNIFICANT DIGITS MaY RESULT IN FIGURE WHICH IS ONLY 
ACCURATE TO NINE FIGURES. THIS RESTRICTION WILL BE LIFTED AS SOON AS 
POSSIBLE. ALL OTHER RESULTS ARE ‘EXACT*.) 
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3.9 VARl£8k££ ALifi &MPniJN£ SXtUiQkS. <AS£A* HANDLING) 


A SYMBOL WHICH HAS BEEN GIVEN A NEW VALUE (BY AN ASSIGNMENT^ qr A 
PULL, ARGS, OR PARSE STATEMENT) IS CALLED A VARIABLE . THE "VALUE" OF A 
SYMBOL IS EITHER THE STRING ASSIGNED fO IT (IF A VARIABLE) qr OTHERWISE 
IS ITS DERIVED NAME. THE DERIVED NAME OF A SIMPLE SYMBOL Is THE UPPEK 
CASe f-nRM OF THE SYMBOL, AS DESCRIBED EARLIER. 

A SYMBOL WHICH DOES NOT START WITH A DIGIT ( ° 9) OR a PERIOD, YET 
INCLUDES AT LEAST ONE PERIOD, IS COMPOUNDS THIS MEANS THAT ITS NAME MAY 
INCLUDE THE V ALUE OF ONE OR MORE SYMBOLS. 

COMPOUND SYMBOLS MAY THEREFORE BE USED TO SET UP ARRAYS AND LISTS OF 
VARIABLES, AND OFFER GREAT SCOPE FOR THE CREATIVE PROGRAMMER. 

THE DERIVED NAME OF A COMPOUND VARIABLE OF THE FORM: 


IS THEN GIVEN BY: 


D0.V1.V2. - .VN 


WHERE DO IS THE UPPER CASE FORM OF THE SYMBOL SO, AND VI TO VN ARE 
THE VALUES OF THE SIMPLE SYMBOLS SI TO SN. ANY OF THE SYMBOLS Sl-SN AND 
VALUES V1—VN MAY BE NULL. 


SOME EXAMPLES FULLOW 
FICTITIOUS REX EXEC: 


/* ASSIGNS 


IN THE FORM CF 


SMALL EXTRACT FROM 


C=•FRED * 

A .B = 'FRED' 

A. FRED=5 
A•C='BILL' 

C.C=A.FR ED 
X.A.B=*ANNIE' 


•FRED* 

•FRED* 


TO VAR NAMED 
TO VAR NAMED 
TO VAR NAMED 
TO VAR NAMED 
TO VAR NAMED 
TO VAR NAMED 


A.4* 

A.FRED * 
A.FRED• 
C.FRED * 

X.3.4* 


SAY A B C A.A A.B A.C C.A A.FRED X.A.4 ? .A 


/* WILL TYPE THE STRING: *3 4 FRED A.3 FRED BILL C.3 5 ANNIE 7.3* */ 
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1 HiLIffiBJiS. ANQ. LANGUAGE E&lEMIL^lU-I* 


symbols are 


RESERVED f 0r 


THE FREE SYNTAX OF REX IMPLIES THAT SOME 
USE BY THE INTERPRETER IN CERTAIN CONTEXTS. 

ONLY NON-COMPOUND SYMBOLS THAT ARE TrlE FIRST IN A KEYWORDS: TH£ 
ARE NOT FOLLOWED BY AN "=" ARE CHECKED TO SEE IF THEY * BE1 nG 1 KEN TO 
SYMBOLS MAY BE FREELY USED ELSEWHERE IN CLAUSES WlTH nui 
BE KEYWORDS. bE RESERVED TO 

WITHIN PARTICULAR INSTRUCTIONS, SOME SYMBOLS MA * h1L E f TC. IN a 
SEPARATE THE PARTS OF ThE INSTRUCTION: FOR EXAMPLE THE « aTQK IN This 
DO INSTRUCTION, OR THE THEN (WHICH ACTS AS A CLAUSE 1“* 

CASE) IN AN IF OR WHEN CLAUSE. 

tjc USER 1F X T IS 

THE KEYWORDS CAN THEREFORE ONLY ADVERSELY AHE FCT T| ^ $ amE NAME (E.G, 

R EX PROGRAMS 


u * uunSE REX PRUbKAMS 

A PROBLEM FOR ANY PROGRAMMER WHO* ^ QR HgR 

TIME AND IN CIRCUMSTANCES DU 1 , .; p o T tQHT • . 

-rr~. . ,, r~ -r. . r- r. r, ^ r. . u C AUCH1 I IT F I Y * W AT fcK 1 A ^ 


DESIRED TO EXECUTE A HOST COMMAND OR SUBCOMMAND WITH 
"QUEUE") AS A REX KEYWORD. 

THIS IS POTENTIALLY 
MIGHT BE USED FOR 

- BSULUICli TH ._ p lRST 

IN THIS CASE A REX PROGRAM May be WRITTEN WITH (AT LE * p T p M .’ Thls 
WORDS IN COMMAND LINES ENCLOSED IN Q TES. E.G: 'ERASE' FN 
ALSO HAS AN ADVANTAGE IN THAT IT IS MORE EFFICIENT. , nTMrc wTT u Tun 

AN ALTERNATIVE STRATEGY IS TO PRECEDE SUCH COMMAND STRINGS W IV.Q 
ADJACENT QUOTES, WHICH WILL HAVE THE EFFECT OF CONCATENATING 'He NULL 
STRING ON TO THE FRUNT. E.G: ''ERASE FN FT FM. A THIRD BUT MORE UGLY 
OPTION IS TO ENCLOSE THe ENTIRE EXPRESSION (OR THE FIRST SYMBOL) IN 
PARENTHESES. E.G: (ERASE FN FT FM). 

IMPORTANTLY, THE CHOICE OF STRATEGY (IF IT IS TO BE DONE AT mLL) IS 
A PERSONAL ONE BY THE PROGRAMMER, AND IS NOT IMPOSED BY THE REX 
LANGUAGE. 

THE POSSIBILITY OF IDENTIFYING ALL REX KEYWORDS BY STARTING THEM 

with a unique character (e.g. ".") was most seriously considered, 

HOWEVER THIS: 

- DOES NOT SOLVE THE PROBLEM SHOULD ONE IN FUTURE BE ALLOWED COMMANDS 
STARTING WITH THAT SAME LETTER 

- DESTROYS ThE NATURAL LOOK OF ThE LANGUAGF WHICH WAS ONE OF THE 
PRIME REASONS FOR ITS INCEPTION. 

IN ADDITION TO THIS, IT WAS FELT THAT ThE PROBLEM is MUCH LESS 
SEVERE THAN THAT OF CHANGES TO THE HOST COMMANDS INVOKED BY THE PROGRAM: 
THESE ARE OFTEN FAR LESS CONTRuLLtD AND MAY EVEN HAVE TOTALLY DIFFERENT 
EFFECTS IN DIFFERENT LOCATIONS. (THIS PROBLEM IS EASED BY RtX'S POLICY 
OF BUILT IN FUNCTIONS STARTING WITH »RX": THESE AT LEAST - 

INTEGRITY). 


May have some 
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ft. lilt. LM3. IMPL EMENTA TION. 

£t«l INSTALLAT ION Aldli till LS.‘- lilt BJL& ££££■ 

THE BASIC REX PACK INCLUDES A (CMS) EXEC WHICH PsRFq Rms SEVERAL 
FUNCTIONS: 

I NSTALLATION : 

"*« ■" *U INSTALL R EX AS * “1 

EXEC 2 AW CPX IP WCESSARX UE I^AVAI^ ^ ^ADy ACllVtl- 

OR EXEC 2 PROGRAMS). THE FUNCTION 
.. REX AS AND IF 


SYSTEM (AND CONTINUE TO RUN EXEC - ■ 

PACKS (REXFNS ETC.) WILL BE LOADED AUTOMATICALLY 


YOU WILL PROBABLY WANT TO PUT THE LINE 
EXEC. 

GENERAL INFORMA T ION 5 


"REX ?" WILL 
FACILITY. 


INTO YOUR PROFILE 


TELL YOU ABOUT REX EXEC AND HOW TO USE THE TUTOR lAL/flELP 


L HCLE f.A£lLUl ; 

"REX" WILL TAKE YOU DIRECTLY TO THE INDEX OF THE TUTORIAL/HELP FACILITY 
- THEN SELECT TOPIC YOU WISH TO READ ABOUT BY NUMBER , KEYWORD, BY 
HITTING PF KEYS, OR BY USING THE LIGHTPEN. 

A MAIN INDEX IS PRESENTED: THERE IS A SUb-INDEX FOR EACH OF 1QX, FSX, 
REXFNS, REXFNS2, REXWCRDS. 

"REX XXXXX” (WHERE XXXXX IS A RcX KEYWORD) WILL TAKE YOU DIRECTLY TO THE 
PART OF THE ONLINE DOCUMENTATION DESCRIBING THAT INSTRUCTION. 

ERROR CODE INFORMATIO N: 

YOU CAN GET EXTRA INFORMATION AND HINTS ON THE LIKELY CAUSES OF REX 
ERRORS BY TYPING "REX NNNNN" (WHERE NNNNN IS THE ERROR CODE, t.G. 
20CC6). 
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1» i.' ' 

4 


£-2 iXSXEH IKltLSEA CES 


PACKAGE, SINCE 1tSiffers^hf C r KRW ' ,T REX IMPLEMENTATION J SYSTEM . ^ 

USES THE SAME INTFRPArc V-> Ht btST WAr OF ‘GETTING INTO „ pL lS T ’ trC *> SQ 
IT IS USABLE 6Y C ° NVErn ln N S AS EXEC 2 (NEW-pOR* PL inTERf AC ? 

WITH EXEC 2. p KOGRAM, SUCH AS XEDIT, CURRENTLY ABLE 

THEH6FORE S I NTERrEPT'- iN f. rALLE0 AS A ^CLEUS EXTENSION CALLER ^lLE {Jjj 

character ^ ■/■ (IE ^ 


IHc rFX language ~ 

WRITTEN IN THE Rlr F ,, F E 
EXEC 2* LANGUAGE FILE aNd 


EXEC2 EXISTS, AND THE CALL WAS 
FIRST WORD IN THfcEl£b WaS 
PASSED DIRECTLY TO IT FOR 
E PASSED DIRECTLY TO THE CMS 


OTHERWISE TT E TR ILE WILL B£ ASSUMED to be 
UTH cRWISt IT IS ASSUMED TO BE AN 'EXEC' 

WILL BE PASSED ON AS APPROPRIATE: 

: E A AIOCX (NUCLEUS EXTENSION) CALLED 
AN EXEC 2 CONVENTIONAL CALL (OR THt 
’•ATRACE") THEN THE PLIST(S) WILL BE 
PROCESSING. OTHERWISE THE PLIST WILL 
EXtC PROCESSOR. 

STMiii r TAMfnuc I 2 HTLr MESSY *ULES ALLOW REX PROGRAMS TO COEXIST ANO bE USED 
WORR ^ f ^r L TH BC1H EXEC 2 AN0 £XEC PROGRAMS, ANO IN ADDITION ALSO 
WORK IE EXEC 2 IS PART OF FhE CMS NUCLEUS. 

SAM^rSwPMTTPMc^c (FR ° M RtX T ° A USEK COMMAND OR SUBCOMMAND) FOLLOW THE 
TH*! 2 ? , c £ \ EC 2 (NEW - E0RM p CIST IS GENERATED, ETC.), EXCEPT 

OVERHEAD MTrHFi^UAr ° NLY 1 Ht SIMPLE ’OLD FORMAT' PLIST TfJ REDUCE 
AUTHORITATlVF C Rmarp CK t oD J0CuMEl Yr ''tXtC2SYS MEMO” IS THE BEST „NJ MOST 
INTERFACES. SUURC E FOR EURTHER INFORMATION ON THE DETAILS OF THESE 

sr««o“o "Ms BE 8 -a^e ED T 0 KE«sED PL1ST " IM w the 

POSSIBILITIES: T Kt,VISED PLIST) WHICH ALLOWS THE FOLLOWING 

*’ ™«"» «* 

?’ pust ««s £ D. 

THAN^Eilc^OR^ •°tflLL M cIS-SE COMMANDS^TQ * A ElLETY?E 0THER 

WITH THE NAME GIVEN. ' ' fS T0 G0 Ta THE ENVIRONMENT 

41 JeMd^s r&i,':* «««» » 

,lmwuKt wh£N * *** 
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CALLING REX WITH A MJLHrEl&M PLiSI: 

BYTE 0 OF R1 = X'OI* (SIGNIFIES NEW-FORM PLIST AVAILABLE) 
RO POINTS TO THE NEW-FORM PLIST: 


** THE NEW FORM PLIST, POINTS TO 1) THE ARGUMENT STRING, AND z) an 
** OPTIONAL FILE BLOCK: 


OF 

A(COMVERB) 
A(BEGARGS) 
A{ENDARGS) 
A(FBLOCK) 


** NEW-FORM PLIST 

-> CL5'EXEC ' (NAME OF INTERPRETER) 
-> START OF ARGS STRING 
-> CHARACTER AFTER END OF ARGs s1r1 nG 
-> FILE BLOCK, OTHERWISE IS A(C») 


** THE FILE BLOCK (ONLY REQUIRED IF REX IS TO EXECUTE A NON- 
** OR IS TO EXECUTE FROM STORAGE) 


XF.C FILE 


** FILE BLOCK 
DC CL8'FILENAME * LOGICAL NAME OF PROGRAM 

DC CL8'FILETYPfc * DEFAULT DESTINATION FOR COMMANDS 

(BLANKS, "EXEC" OR " '• BOTH CAUSE 
COMMANDS TO BE PASSED TO CMS) 

DC CL2 *FILEMQOE• . SHOULD NORMALLY BE ** • OR • » 

DC H*EXTLEN' LENGTH UF EXTENSION BLOCK IN FULL- 

WORDS: H•2' IF IN—STORE EXECUTION 
IS DESIRED, H *0 * OTHERWISE. 

EXTENSION BLOCK STARTS HERE (ONLY REQUIRED FOR IN—STORAGE PGM) 
DC AL4(PGMF ILh) -> START OF PROGRAM DESCRIPTOR LIST 

DC AL4(PGMEND—PGMFILE > LENGTH OF PROGRAM DESCRIPTOR LIST 


** DESCRIPTOR 
PGMFILE DS 
DC 
DC 


LIST FOR IN-STORAGE 
OF 

A(LINE 1 ) ,F‘LEN1* 

A ( L INE 2 ) ,F ' LEN2 • __ 


PROGRAM 

** IN STORAGE REX/EXEC 2 
ADDRESS, LENGTH OF LINE 1 
ADDRESS, LENGTH OF LINE 2 


PROGRAM 


DC A(LINEN)jF’LENN* 
PGMEND EQU * 


ADDRESS, LENGTH OF LINE N 


NOTES: 

THE IN-STORAGE PROGRAM LINES NEED NOT BE CONTIGUOUS, SINCE EACH IS 
SEPARATELY DEFINED IN ThE DESCRIPTOR LIST. 

FOR IN-STORE EXECUTION, FILENAME AND FILE TYPE ARE STILL REQUIRED IN 
THE FILE BLOCK, SINCE THESE DETERMINE THE LOGICAL PROGRAM NAME AND THE 
DEFAULT COMMAND ENVIRONMENT. 
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, STANDAR D £UNCII2ii 


REX INCLUOtS 


R6XW0RDS. 

needed, Oi. 

COMMAND. ALL THR6- 

argument "?”• 

FOR THIS FUNCTION). 


THEIR NAME AS a 


THe B E "e X P LI £ IT L Y LOADED BY ISSUING • . 

THEY. MAY^ BE ABQUT THEMSELVES WHEN INVOKED 

REXFNS2 STACKS A COMMAND WHICH INVOKES IOS327G 


ft. 2.1 51XR& 

THE BASIC SET of EXEC-LIKE FUNCTIONS ARE INCLUDED IN THE 'RtXFNS* 
PACKAGE. 


DATATYPE (STRING) 

SYMBOL('NAME* ) 
TRANS(STRING,TABO,TABl) 

LENGTH(STRING) 
WCOUNT(STRING) 
INDEX(HAYSTACK,NEEDLE ) 

POS1NEEDLE,HAYSTACK) 

LASTPOS( NEEDLE,HAYSTACK) 

REPEATC STRING,N) 
SUBSTR(STRING,N,K) 

DELSTR(STRING,N,K) 

TRUNCISTRING.N) 

READFLAGt) 

NEST(> 

USERIDl) 

0ATE( ) 

TIME( ) 


RETURNS 'NUM* IF THE STRING IS A VALID NUMBER 
OTHERWISE RETURNS 'CHAR*. 

RETURNS 'VAR* IF THE SYMBOL NAMED HAS BEEN 
ASSIGNED A VALUE, OTHERWISE RETURNS ’Ll I . 
PL/I-L1KE TRANSLATE FUNCTION. IF NEITHER 
TRANSLATE TABLE IS GIVEN, THE STRING IS 
TRANSLATED TO UPPER CASE. TABI IS INPUT 
TRANSLATE TABLE (DEFAULT IS FULL EBCDIC SET), 
AND TABO IS OUTPUT TABLE (WHICH IS PADDED 
WITH BLANKS OR TRUNCATED AS NECESSARY). 
RETURNS THE LENGTH UF THE STRING 
RETURNS THE NUMBER OF WORDS IN THE STRING 
RETURNS THE POSITION OF THE NEEDLE IN ThE 
HAYSTACK (SAME FORMAT AS PL/I). 

ALSO RETURNS THE POSITION OF THE NEEDLE IN THE 
HAYSTACK (NOT AS IN PL/I). 

RETURNS THE POSITION OF THE LAST OCCURRENCE OF 
THE NEEDLE IN THE HAYSTACK. 

RETURNS N+l CONCATENATED COPIES OF STRING 
RETURNS THE SUBSTRING OF STRING WHICH BEGINS 
AT THE NTH CHARACTER, AND IS OF LENGTH K, 
PADDED WITH BLANKS IF NECESSARY. 

DELETES THE SUBSTRING OF STRING WHICH BEGINS 
AT THE NTH CHARACTER, AND IS OF LENGTH K 

returns integer part of number, and up to n 
DIGITS AFTER THE » (DEFAULT N=C). | NQ PAD) 
RETURNS * CONSOLE' OR 'STACK' DEPENDING K FROM 
WHERE THE NEXT "PULL" WILL READ. FR0M 

RETURNS CURRENT DEPTH OF NESTING OF F v C „ 
(INCLUDING CMS AND EXtC 2 EXECS) LS 

RETURNS THE VIRTUAL MACHINE USERIq. 

RETURNS THE DATfc E .G. » 8 Q * 

RETURNS THE LOCAL TIME E .G . . 04; ^ ™ » 



n 
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REA£NS.a 

REXFNS2 INCLUDES A NUMBER OF HIGH LEVEL CHARACTER MANIPULATION 
FUNCTIONS, TOGETHER WITH A USEFUL SET OF CONVERSION ROUTINES ETC 

NOTE: FOR FUNCTIONS WHICH PROVIDE FOR A "PAD" CHARACTER, * THE PAD 
CHARACTER IS OPTIONAL: IF SPECIFIED, THE SHORTER STRING i S EXTENDFD ON 
THE RIGHT WITH THE PAD CHaRATER, OTHERWISE, THE OPERATION Is PERFORMED 
ONLY ON THE PORTIONS OF THE STRINGS WHICH CORRESPOND IN LENGTH. 


AND(STRING1,STRING2,PAD) 
CLCH STRINGI,STRING2, PAD) 


CLXL(STRING1,STRING2, FAG) 


COUNTBUFI) 

D2X(NUMBER,K) 


E2X(STRING) 
FETCH(ADDRESS,K) 


LOCATE(NEEDLE,HAYSTACK,N, 


QR(STRING1» STRING2, PA U) 

REVERSE(STRING) 

. SUBSETt) 

TM(STRING,MASK,PAD) 


TRT( STRING, REFERENCE,-.) 


RETURNS THE LONGER OF THE TWO STRINGS, WITH 
WHICH THE SHORTER HAS BEEN LOGICALLY ANDED 
LOGICALLY COMPARES TmE TWO STRINGS AND RETURNS 
THE POSITION OF THE FIRST CHARACTERS WHICH 
MISCOMPARE (ZERO IF THE STRINGS' ARE EQUAL, 
NEGATIVE IF STRING 1 IS LESS THAN STRING2. 
LIKE CLCL EXCEPT THAT THE■COMPaRI SON IS 

ARITHMETIC, AND THE STRINGS ARE HEXADECIMAL. 
RETURNS NUMBER OF RECORDS IN CONSOLE STACK. 
RETURNS A CHARACTER STRING OF LENGTH »K" 

(»K“ IS BETWEEN 1 AND 8) WHICH IS THE 
HEXADECIMAL REPRESENTATION OF THE DECIMAL 
INTEGER "NUMBER". IF “K" IS OMITTED, 

LEADING ZEROS ARE SUPRESSED. 

same as the rex notation 'string*x, except 

THAT "STRING" MAY BE A VARIABLE. IE 'PACK*. 
RETURNS THE CONTENTS OF "K" BYTES OF THE 

USER'S VIRTUAL MEMORY STARTING AT "ADDRESS". 
BOTH "ADDRESS" AND »K» ARE PACKED HEXA¬ 
DECIMAL VALUES. EG 'C2CC0C‘X. 

'-.*) RETURNS THE POSITION OF THE N'TH 
. OCCURRENCE OF "NEEDLE" IN "HAYSTACK" (OR, 

IF »-.' IS SPECIFIED, THE N'TH OCCURRENCE OF 
ANY STRING IN "HAYSTACK" WHICH IS EfcUAL IN 
LENGTH TO "NEEDLE" BUT WHICH IS NOT EQUAL 
TO "NEEDLE"). IF »N" IS NEGATIVE, THE 
SEARCH IS RIGHT TO LEFT. (NOTE: THIS 
FUNCTION IS DISK RESIDENT, NOT IN REXFNS2). 
RETURNS THE LOnGEk uF THE Twu STRINGS, WITH 
WHICH THE SHORTER HAS BEEN LOGICALLY ORED. 
RETURNS "STRING", SWAPPED END FOR END. 

RETURNS 1 IF IN SUBSET, C OTHERWISE. 

THE BITS OF "STRING" ARE TESTED BYTE FOR BYTE 
UNDER THE "1" BITS OF "MASK" (ONLY "MASK" 

MAY BE EXTENDED WITH THE PAD CHARACTER). 

ZERO IS RETURNED IF ALL BITS TESTED WERE 
ZERO; -1 is RETURNED IF ALL BITS TESTED WERE 
. . ONE; OTHERWISE, THE POSITION OF THE FIRST 
Character in "string" which caused a "mixed 

ONES AND ZEROS" CONDITION IS RETURNED. 

RETURNS ThE POSITION OF THE 1ST CHARACTER IN 
"STRING" WHICH IS NOT ALSO IN "REFERENCE", 

OR, IF ls SPECIFIED, THE POSITION OF THE 

FIRST CHARACTER IN "STRING" WHICH IS IN 
"REFERENCE". 
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TYPEFLAG(HT OR RT) 

VERIFY(STRING,REF£RENCE 
XQR(STRING1,STRING2,P AD ) 

XRANGE(M ,N ) 

X2D(HEXSTRING> 

X2E(HEXSTRING) 


^yplNG OR 

RETURNS HT OR RT. wlLL n R L RT 1$ ^ ClF 

resume typing ip ^'T. 0R oT mGS» WIT H 

) SYNONYM FOR TRf ABOVE. s fRl y XDR£ D 

returns THE LONGER OF THE ‘ L0&%nES * 

WHICH THE SHORTER HAS B t C 0 

RETURNS A STRING OF ALL „ N «». 

BETWEEN THE VALUES M mAL . c - fnTATI q N 

CONVERTS "HEXSTRING" TO DECI r£pRtS EN iUN 

RETURNS THE EBCDIC CHARACTER 
OF "HEXSTRING"• IE. UNPACKS. 


£-•1.3 R. EXWOROS 

SOME USEFUL 'WORD PROCESSING* FUNCTIONS 
ALL THESE FUNCTIONS NORMALISE THE STRING 
TRAILING BLANKS. AND REDUCE INTER - WORD GAPS 


tm thF •REXWORDS' PACK. 
ARE IN THE ' p.niNG AMn 


LEFT(STRING,K) 
RIGHT(STRING,K) 
CENT(STRING,K) 
JUSTIFY(STRING,K) 
SPACE(STRING»N) 
WORD(STRING,N) 
FIND(STRING,PHRASE) 


TU .ctrING’ LEFT 

RETURNS A STRING OF LENGTH K WITH E£DtDf 

JUSTIFIED AND PADDED WITH BLANKS IJ RIGHT 

RETURNS A STRING OF LENGTH K WITH STRI 
JUSTIFIED AND PADDED WITH BLANKS IF Nt 
RETURNS A STRING Or LENGTH K WITH -STRING CLNTRuD 
CENTERED IN IT. E.G* CENT(ABC,7) => " ^ 

FORMATS THE WORDS IN THE STRING, BY ADDING BLANKS 
BETWEEN WORDS, TU JUSTIFY TO BUTH MARGINS. 

FORMATS THE WORDS IN THE STRING WITH N SPACE., 

BETWEEN WORDS. N MaY BE 0, TO REMOVE ALL BLANKS. 
RETURNS THE NTH WORD IN THE STRING. E.G: 

WORD!'NOW IS THE TIME*,3) => ‘THE* 

FIND THE WORD NUMBER OF THE FIRST WORD IN THE 

PHRASE. RETURNS C IF THE PHRASE IS NUT FOUND, .... 
E.G: FI NO (NOW IS THE TIMt.lS THE) =G> *2* 
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IN CMS. REX FUNCTIONS ARE CALLED VIA SVC 202, USING A SPECIAL SEARCH 
ORDER (SEE THE DIAGRAM Al THE END OF THIS S ^ T1 ^’ : ThE FUNCTION 

NAME IS *EXbC 1 » REX WILL PREFIX *RX' TO THE FUNCTION NAME GIVEN 
(TRUNCATING ON THE RIGHT IF NECcSSARY) AND WILL THEN ATTEMPT T0 pxECUTE 
THE RESULTING FUNCTIUN USING SVC 2u2. 1 h 1 s NOT FOUND, 

THEN THE FUNCTION PACKS WILL BE INTERROGATED AND LOaDIED if NECESSARY 
(THEY RETURN kC = 0 IF THEY CON f AINED THE REwUESTtD FUNCTION, OR RC = 1 
OTHERWISE). IF STILL NUT FOUND, THEN THE NAME IS RESTORED TO ITS 

ORIGINAL FORM AND RE-EXECUTED WITH SVC 202 (IF STILL NOT FOUND, AN 

ERROR IS RAISED ). THIS MECHANISM ALLOWS FUNCTIONS TO BE WRITTEN 

WITH LITTLE CHANCE OF NAME CONFLICT WITH EXISTING MODULES. 

WHEN THE FUNCTION RECEIVES CONTROL, REGISTER 1 POINTS TO a NORMAL 
CMS PLIST, AND THE TOP BYTE OE R1 IS X'OC. REGISTER C POINTS TO A LIST 
OF ARGUMENT DESCRIPTORS, BEING A SERIES OF FULLWORD PAIRS. THE FIRST 
VALUE IN EACH PaIR IS THE ADDRESS OF THE ARGUMENT CHARACTER STRING, AND 
THE SECOND VALUt IS IT'S LENGTH (WHICH MAY BE 0). THE FINAL VALUE. PAIR 

IS FOLLOWED BY TWO FULLWORDS CONTAINING F'-l lit. X•FFFFFFFF*). 

CURRENTLY THERE IS A MAXIMUM OF SEVEN ARGUMENTS ENFORCED. 

DURING CALCULATION OF THE RESULT, THE FUNCTION MAY USE THE ARGUMENTS 
(WHICH RESIDE IN USER STORAGE OWNED BY RtX) AS WORK AREAS, WITHOUT FEAR 
OF CORRUPTING INTERNAL REX VALUES. 

THE RESULT MUST Bt RETURNED TO REX IN A BLOCK OF STORAGE ALLOCATED 
BY DMSFREE AND WHICH HAS Tut FOLLOWING STORAGE ASSIGNMENTS AND VALUES: 


*— DSECT FOR THE RETURNED DATA BLOCK • 
EVAL6L0K DSECT 

EVBPAD1 DS F 

EVS1ZE OS F 

EVLEN DS F... . 

EVBPAD2 DS F 

EVDATA DS.C. __ _ 


RESERVED 

TOTAL BLOCK SIZE IN OW'S 
LENGTH OF DATA (IN BYTES) 
RESERVED 

..THE. RETURNED CHARACTER STRING 


THE ADDRESS OF THIS BLOCK SHOULD BE STORED IN THE FIRST FULLWORD OF 
THE ARGUMENT LIST (I.E. THE LOCATION POINTED TO BY REGISTER C ON ENTRY 
TO THE FUNCTION). 

THIS BLOCK WILL ONLY BE ACCEPTED (AND LATER FREED) BY REX IF THE 
FUNCTION RETURNS A ZERO 'RETURN CODE'...IN REGISTER 15. 

THIS INTERFACE HAS THREE MAJOR ADVANTAGES: 

THERE IS NO RESTRICTION ON THE CONTENT OF THE DATA RETURNED. 

THERE IS NO RESTRICTION (OTHER THAN YOUR VM SIZE) ON THE LENGTH OF 
DATA RETURNED. . 

THE RETURNED BLOCK IS IMMEDIATELY USABLE BY REX, WITHOUT NEED TO 
COPY THE DATA. 

USING THE STACK WOULD REQUIRE TWO INVOCATIONS OF THE STACK HANDLING 
ROUTINES FOR EACH AKGuMtMT AND RESULT. THIS OVERHEAD IS AVOIDED. 
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CALLING EXECS AS FUNCTIONS WORKS THE SAME WAY, Wl rH 
POINTS BEING RELEVANT: £ 

1) only one argument string is used by rex (others ar 

2) THE ARGUMENT STRING IS RESTRICTED TO 240 BYTES 


52 .: 

the follow^ 

iG NORED) 

dI RECTLY, 


Ihfc ARGUMENT STRING IS RESTRICTED TO 240 BYTES. K D ikcv>.*-t, 

3) THE RETURN INSTRUCTION WILL PASS BACK A REX EVALBL £sTR ICTIOn 
INSTEAD OF USING THE STACK. THERE IS THEREFORE NU 

ON THE LENGTH OR CONTENT OF THE DATA RETURNED. £N y TO THE 

4) THE SPECIAL PROCESSING INVOLVED IN THIS IS TRANSPAK 

USER. T *x: 

5) YOU MAY INVOKE AN EXEC AS A FUNCTION USING THE SYNT 

•EXEC FRED*(ARGSTRING) , sS iGN THE 

since this is rather cumbersome, you may prefer tu 

LITERAL TO A VARIABLE FIRST FOR USE AS REQUIRED, JHU ’ */ . 

FR='EXEC FRED 1 ; /* NOW »FK(aRGSTRING)" WILL 


THE THREE MAIN FUNCTION 


packs also respond to , 


rexname load rxfname 


IF RXFNAME is CONTAINED WITHIN THE -PACK REXNAME, THEN If Wl L L ? AD 

ITSELF AND RETURN RC=C, OTHERWISE RC=1 IS RETURNED. THIS ALLOWS THE 
FUNCTION PACKS TO BE AUTOMATICALLY LOADED BY REX WHEN NECESSARY. 



n 


O 



P 

P 


1 
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REX FUNCTION EikiflkUIIOfi Mi2 £AL£UIlLl£i: 

""•a 

START I 


^fllftltfll »»«M 

!£*»YES"3 IS FUNCTI 

II II *>-.*11 n nil 


»"g> 


NAME ‘EXEC 1 ? *“NO»a 

IIII II il II » f« II t« IIII If HI It Ik ^ | 

^ Iff! If fill tiff till 
it mi filler lift it ilitilj) 

| PREFIX NAME | 

| WITH *RX« | 

II tl Hit Itltgtttl Illllltl^ 
gll It II Itil Illinium till lllig 

| EXECUTE SVC I 

ii ii ii sin ii ti gg mi ii it» mi jf 

I 

git till <111 till ^11II II till UK a 

| WAS FUNCTION 
? 11 YES'* <9 FOUND 


n mm n ii ii ii it 


n it nun min nit n Hi* ii 


I 


%" NO 

I 

I 

v , mi Uf i. 


'"•a 


i EXECUTE | 

| AUTOLOAD | 

t .lining mi ii n ft 

I 

^tt iitt it^r tttf if ttg) 

I AUTOLOAD | 
£'"'YES nn # FAILED? ?>'NO“# 

I 


% M tin ft lilt y If H tl itil i» 

I SUBTRACT | 
| 'RX* PREFIX | 
f ii nmi ling mi ii uaiiff 


I 

?''YES”3 

.I . 

i : : 

% *»*» H tty H»»Hr it 2 ) 

I FINISH | 

, ****** It Ml 


<£tttl itttft tt!t y ttit tttlM 

I EXECUTE SVC I 

y t» till till tlil^flfl tf II t»|| f« £ 

I 

<£ 111111(111 nit^nitit mi ling 

I WAS FUNCTION I 

FOUND ? ?"N0“3 

II *l»«l| fill II Ilf! ||fV^ | 

I 

tinny tin ting 

I ERROR I 

y ti ini mi mi it »t£ 
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ft-5. DIRECT INTERFACE TO REX VARIABLES 

rEX versions 

(NOTE: This SECTION DESCRIBES THE INTERFACE FOR aE rE COMPLICATED 
SINCE 1.12. EARLIER VERSIONS HAD A DIFFERENT AND M C QpI tS ^ lQ X, 

calling mechanism, and a more restricted ig-syte plIST r( ;nT kc lEA -' es *> 

FSX, ETC. PRIOR TO MARCH 19G0 ARE INCOMPATIBLE WITH CURRt 

COMMANDS MAY 

REX (UNDER CMS) PROVIDES AN INTERFACE WHEREBY CALLt ^ VARIABLES. 
easily access and manipulate the current generation of rED aLL TH( . 
VARIABLES MAY BE INSPECTED, SET, OR DROPPED; AND IF REt, QN 0 F INTERNAL 
ACTIVE VARIABLES MAY BE INSPECTED IN TURN. ALL MANIPULAl^ A( „ s nQ ^ 
REX WORK AREAS IS CARRIED OUT BY REX'S ROUTINES: USER ^// R r A s|_ES ACCESS 
THEREFORE NEED TO KNOW ANYTHING OF THE STRUCTURE OF THE VAf. 

METHOD (WHICH INCLUDES HASH TABLES, ETC. ETC.). 

THE INTERFACE WORKS AS FOLLOWS: 

WHEN REX STARTS TO INTERPRET A NEW EXEC OR EDITOR MACRO Program 
SETS UP A SUBCOMMAND ' ENTRY POINT CALLED ••EXECCOMM". " 

(COMMAND OR SUBCOMMAND) IS INVOKED BY REX, IT MAY IN 1Ur< ^ " 

CURRENT EXECCOMM ENTRY POINT TJ SET, REAu, OR DROP REX VARIABLES U^iNG 
REX'S INTERNAL ROUTINES. r , 

THE INTERNAL ROUTINE REXVAR CARRIES OUT ALL CHANGES TO PLJINItRS, 
ALLOCATION OF STORAGE, SUBSTITUTION OF VARIABLES IN THE NAME, ETC. HENCE 
ISOLATING USER PROGRAMS FROM THE INTERNAL MECHANISMS 0 e REX. 

TO ACCESS VARIABLES, A PLIST MUST BE SET UP (SEE BELOW), AND THEN AN 
SVC 202 SHOULD BE ISSUED (WITH R1 POINTING TO THE PL 1ST, AND THE TOP 
(FLAG) BYTE OF R1 SET TO X'02'l. 

RO MUST BE SET TO 0. FUTURE EXTENSION MAY POSSIBLY USE RC TO POINT 
TO A NORMAL NEW-FORM PL1ST WHICH WILL CONTAIN A STRING TO 6E 
INTERPRETED. 

ON RETURN FROM THE SVC, R15 WILL CONTAIN THE RETURN CODE FROM THE 
ENTIRE PLIST. THE POSSIBLE RETURN CODES ARE: 

R15 = 0 ENTIRE PLIST PROCESSED SUCCESSFULLY 

-I INVALID FUNCTION REQUEST 

-3 (FROM SUMCOM) NO EXECCOMM ENTRY POINT FOUND: IE NOT CALLED 
FROM INSIDE A REX EXEC. 

5 INSUFFICIENT FREE STORAGE AVAILABLE TO EXECUTE 

30 a NAME (FOLLOWING ANY SUBSTITUTION) WAS TOO LONG (>I5C) 


NAME MAY BE NUMERIC. (FIRST CHARACTER 


OR ' . •) 


NOTE THAT A VARIETY OF OTHER NAMES, ILLEGAL FOR USE WITHIN 
REX, MAY BE USED BY THIS INTERFACE: THIS ALLOWS PkortiAMS 
TO USE 'SAFE* NAMES. 

NOTES: 

REXVAR RUNS WITH INTERRUPTS ENABLED FOR MOST OF THE TIME 
THE INTERFACE MAY BE DISABLED BY SETTING THE FIRST BYTE*OF THF DWORD 
IN THE SCBLOCK TO X'OC. REX WILL THEN REPLY 'INVALID FUNCTION neniiFST* 
<R15=-1) IF ANY COMMAND TRIES TO ACCESS VARIABLES. RESTORING THE BYTE 
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TO X • FF • WILL RE-ENABLE THE INTERFACE. 


the Pi 1ST MUST CONSIST OF THE EIGHT BYTE STRING ’EXECCOMM* FOLLOWED BY 

number of Consecutive 20-byte blocks (so allowing multiple 

OPERATIONS) THUS: 


REXENTPL DSECT 
REXENTNM DS CL8 
* THE NEXT 20 bYTES 
REXENTFN DS CL 1 


REXENTFG DS CL 1 


DS CL2 
REXENTNA DS ALA 

REXENTNL DS F 

REXENTDA DS ALA 

REXENTDL DS F 

* RcXENTDA & REXENTD 


MUST BE SET TO ‘EXECCOMM*, THE SUBCOMMAND NAME. 
MAY BE REPEATED AS OFTEN AS REQUIRED 
PLIST FUNCTION CODE: 

C *D• = DROP VARIABLE 

C * Q * = QUERY (READ) VARIABLE 

CN* = QUERY NEXT LOGICAL VARlARLE (SEE BELOW) 
C•S‘ = SET VARIABLE 

X «FF» = END OF PL 1ST 
FUNCTION RETURN CODE (SET BY REX) 

X * 00 * = OPERATION COMPLETED OK. 

XI 01 * = VARIABLE DID NOT EXIST BEFORE OPERATION 

FOR: DROP: NO OTHER ACTION TAKEN 

QUERY: MO OTHER ACTION TAKEN 

SET: VARIABLE CREATED AND SET 

X ,Q2‘ = (AFTER "N" FUNCTION ONLY) LAST VARIABLE 

HAS SEEN QUERIED. 

RESERVED FOR FUTURE USE, SHOULD BE SET TO X*C000‘ 

ADDRESS OF VARIABLE NAME BUFFER 

LENGTH OF VARIABLE NAME (CURRENT MAX 150 

ADDRESS OF DATA BUFFER 

LENGTH OF DATA BUFFER 

l: SHOULD BE SET BY THE USER IF FUNCTIONS S’ 

ARE SET BY REX IF FUNCTIONS’ OR ’N‘ 

AND REXENTFG=X*TO’ 

ARE NOT ALTERED IF REXENTFG IS NOT X*C0‘ 

ARE NOT USED IF FUNCTIONED* 


R1, UPLI ST 
R1,6*1000* 


EXECUTION WAS OK 


( FULLY RELOCATABLE (NUCXLOADABLE ) AND 


CLEAR RC 

-> USER PLIST, AS ABOVE 
INSERT "SUBCOMMAND CALL" FLAG 
ALIGNMENT 

PREPARE ERROR EXIT ADDRESS 
ISSUE SVC 

ADDRESS OF "BR 14" IN NUCON 

TEST RETCOOE -.non Tf ERROR 

QUIT IF WE HAD A CATASTROPHIC ERROR 





r 
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usE D T ° SEA *C H 


THE FUNCTION 'QUERY NEXT LOGICAL VARIABLE* ^ RE$ -, 

THOUGH ALL THE VARIABLES KNOWN BY REX (AI THE CURRENT TH fcSb T HAM .m, 

REX MAINTAINS POINTERS TO ITS LIST OF VARIABLES* QfH 
WHENEVER 1) A HOST COMMAND IS ISSUED, OR t) ANY FUNC I □ f T U R N Tm c 

IS EXECUTED VIA THIS DIRECT VARIABLES INTERFACE. W ILL R HE 

WHENEVER AN * N * (NEXT) FUNCTION IS E XECUTE 0 , RE * jnG T ° (UNTIL Cj 
LENGTHS AND ADDRESSES OF THE NAME AND DATA Pf*™I , N i ‘ 

LOGICAL VARIABLE KNOWN TO IT. BY REPEATEDLY EXbCUTI MA y L 

RETURN FLAG IS SET TO X*C2* IN THE PLIST) A USER P R ^* TO THE REAL. 

THE CURRENTLY ACTIVE REX VARIABLES. THE ADDRESSES p ' Tri0 uGH THfc 
DATA, SO THE USER MaY ALTER THE DATA IF DESIRED, 

CANNOT BE CHANGED. „ c r*TlV£» 1E I ’ ™ EN 

THE RETURN CODE FROM FUNCTION *N* WILL BE C OR NB vA rIABLE HAS BEEN 
IF REXENTFG IS SET TO X*Grr* THEN THIS INDICATES THAT A pulST . X*02* Ii\| 
FOUND AND THE POINTERS AND LENGTHS HAVE BEEN PUT IN I " = THE INTERNAL 
REXENTFG INDICATES THAT THE LAST VARIABLE HAS BtEN STORED IN THE 

POINTERS HAVE eEEN RESET, AND NO VALID uATA HAS BEt 


PLIST. 

IN THIS MANNER A PROGRAM (SUCH AS TiiE 
INSPECT ALL THE VARIABLES CURRENTLY KNOWN. 


REXDUMP' 


DEBUG AID) MAY' 


A 

54 f. 

A 

66 : 

"A i 

. 60 ' . 
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4.6 U SING SERVICE PROGRAMS. Siild. (U1X. £!£,.) 

ALL COMMANDS THAT MAY 6t CALLED FROM EXEC OR 2 USED WITH 

REX, EXCEPT THAT THOSE WHICH ATTEMPT TO SET OLD EXbC VARIABLES MAY NOT 
WORK. SOME MODULES WHICH ARE l-SRECIALLY USEFUL ARE. 

iqx• IS A SERVICE PROGRAM WHICH WAS WRITTEN ESPECIALLY FOR USE* WITH 
nrv AND ,c RECOMMENDED. IT MAY BE USED TO READ, WRITE, UPDATE, AND 
SE«“ FIUS- Sk JuNCrt RECORDS; SET ULOS.L VARIABLES; EIC . 

p <- y . re a qpv SERVICE PROGRAM DESIGNED TO GIVE USERS COMPLETE 

CONTROL* Of FULL SCREEN DISPLAY'S < E.G. MODELLING FUTURE 

APPLICATIONS). 

STACKIO: HAS VERY MANY USEFUL FEATURES AND IS FULLY COMPATIBLE WITH 
REX, HOWEVER ITS I/O IS LIMITED TO THE WIDTH OF THE STACK. 

EMSG: HAS THE SAME EFFECT AS &EMSG IN CMS EXECS. 

IOS327 n * RtC c NT VERSIONS WILL (1 UNDERSTAND) DETECT WHEN THEY ARE 
CALLED FROM EXEC 2 UR HEX. OLDER MODULES MAY FAIL TO RUN 

SATISFACTORILY. THE EXEC VARIABLES &IOSK ETC. WILL NOT OF COURSE BE SET 
WHEN IOS 327 B IS CALLED FROM EXEC 2 OR REX, NOR MAY VARIABLES BE INCLUDED 

IN THE DATA STREAM. A NEW VERSION, COMPATIBLE WITH THE REX V ARiA b Lb S 

INTERFACE, IS EXPECTED VERY SOON. 

MODULES: CHECKS WHETHER LISTED MODULES EXIST ON ANY DISK: A MESSAGE 
IS TYPED FOR ANY THaT COULD NOT BE FOUND. 

EXSERV: ALL FUNCTIONS OTHER THAN THOSE WHICH ATTEMPT TO SET EXEC 
VARIABLES SHOULD 6E USEABLE. 

GLOBALV: ALL FUNCTIONS OTHER THAN THOSE WHICH ATTEMPT TO SET EXEC 
VARIABLES SHOULD BE USEABLE. 

PROMPT: A VERSION IS AVAILABLE WHICH WILL USE THE NEW FORMAT PLIST 
PROVIDED BY REX/EXEC 2. IT PROMPTS THE USER WITH DATA ON LINE 23. 

REXOUMP: A DEBUG AID WHICH "DUMPS" UP TO 60 CHARACTERS OF EACH 

VARIABLE, AND THE LENGTH OF THE VARA1ABL6, TO THE SCREEN. 

DRAINSTK: PURGES ALL BUFFERS FROM THE INPUT CONSOLE STaCK WITHOUT 
AFFECTING THE OUTPUT STACK. 

HT, RT: HALT/RESUME TYPING.. SAME AS STACKING HT, RT IN CMS EXEC. 

OSRE SET: A MODULE WHICH RESETS OS SIMULATED STORAGE. SHOULD BE 
INVOKED BETWEEN PL/I MODULE CALLS, FOR EXAMPLE, WHICH CAN OTHERWISE FAIL 
WITH A "VIRTUAL STORAGE SIZE EXCEEDED" MESSAGE. (ALSO USEFUL WITHIN 
EXEC 2 EXECS FOR THE SAME PURPOSE). 


* 



o 


r 
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*2 Rt& PROGRAM structure 


THE FOLLOWING INFORMATION MAY BE OF INTEREST TO SOME 

REX IS IMPLEMENTE D AS EIGHT C SECTS WHTrw rnr.PTWFR F0 ^ 
MODULE THAT IS FULLY 
CODE IS CONTAINED II 
FOR RUNNING UNDER A 
ASSEMBLE AND REX MACR 


; A D£ RS: 

A READ—ONLY 


BRIEFLY, THE APP 
FUNCTION OF EACH CSEC 

REX 

REXCONV 
REXEVAL 
RtXEXEC 
REXINT 


REXSAY 

REXTRACE 

REXVAR 


RELOCATABLE AND RECURSIVE. ALL BE MODIFIED 

trivial macros, so in theory rex mat wrITING r £x 

DIFFERENT OPERATING SYSTEM BY JUST 
i, THEN RE-ASSEMBLING THE OTHER CSECT^' 

- COMMENTS) AND 

ROXIMATE SIZE (IN SOURCE LINES + 

T IS: 

1 - RtAOS THE EXEC FILE AND CALLS REXlNT ’ T . ul^S. ’ 
HANDLE'S THE DIRECT INTERFACE TO VAR 
-. CONVERSION (NUMERIC <—> blNARY) R0Uil 
- - THE EXPRESSION EVALUATOR. ri mil f S 

. - EXECUTES THE, INDIVIDUAL INSTRUCTION CLAD--' • 

■ - PARSES THE INPUT DATA, CONTROLS MOST fcXELU i N 
. DECISIONS, AND PASSES CLAUSES FOR EXELUliUN IU 
REXExEC. 

SAY (DISPLAY ON TERMINAL) ANY LENGTH DAIA. 

! - FORMAT AND DISPLAY TRACE INFORMATION 

ACCESS REX VARIABLES, USING HASH TABLE ETC. 


REX MACRO IS ABOUT 1110 LINES (60‘S OF WHICH ARE COMMENTS ETC.). 


THE REX PACKAGE INCLUDES OTHER FILES AND UTILITIES, OF COURSE, AND 
THE APPROXIMATE- SIZE OF THE MORE IMPORTANT OF THESE IS (AGAIN, IN 
LINES): 

REXFNS - 1260 - STANDARD BUILT-IN FUNCTIONS 

REXWORDS - 790 - WORD PROCESSING BUILT-IN FUNCTIONS 

REX EXEC - 15C - ON-LINE INSTALLATION AND DOCUMENTATION CONTROL 

10SLI3 - 2640 - ON-LINE DOCUMENTATION 

SCRIPT - 26C0 - (THIS DOCUMENT) 



o 

1 

» 


1 
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4.S nm aiLlMG.ki&L 


BP Til P c ' ^ 1 n ' 

du m .. i neon.. hv i. UTM^ j 1 PxFfiJTED BY EXf-r ^ A 

MlZtlZ &If£ i- ] 


IN SOME CIRCUMSTANCES IT MAY BE OESIRABLc TO WRITE bXtCS THAT WILL 

run kather 

THAN •/*•: BOTH THESE ALTERNATIVES ARE TAK.N JO BE ~ 

COMMENT 

IS NOT JNBIALLLUj IMCii • ...-• - rriMTATN 'OLD' ever 

BY IT TOO: SUBSEQUENT LINES MAY THEN ■ C LANGUAGE 

STATEMENTS. 

E.&: 

*/* THIS IS A TRIVIAL BILINGUAL EXEC 

AGOTO -OLD */ T . , i cn , 

SAY « THIS IS EXECUTED WHEN REX lo INSTALLED 
EXIT 

&TYPE THIS IS EXECUTED BY EXEC WHEN REX IS NOT INSTALLED 

THE TECHNIQUE MAY BE USED TO ALLOW AN EX*rC TO BE WRITTEN IN REX 
WHICH HAS STATEMENTS Af THE START TO INSTALL REX AND RE-INVOKE THE EXEC 
IF REX IS NOT ALREADY ACTIVE. THE FOLLOWING SEQUENCE MAY BE USED AFTER 
THE LABEL -OLD ABOVE TO ACHIEVE THIS: 

^CONTROL OFF 
EXEC REX I 

A IF ARETCODL- EQ C EXEC . 

A EXIT ARETCODE 


. A1 A2 A3 A4 ,55 A6 A7 ... 


NOTE THAT EXEC 2/RtX BILINGUAL EXECS ARE NOT POSSIBLE SINCE THE 
MEANS BY WHICH THEY ARE RECOGNISED ARE MUTUALLY EXCLUSIVE. 
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5. EXAMPLE EXECS FOR. CM£ R£X 


ADG1 £X££. 


/* DISPLAYS FULL ADDRESS AND NAME FOR NICKNAMES SPECIE 163 ’ 


HCKNAME */ 


It . ARGS ENAME REST 

IF REST ='' I REST=? THEN SIGNAL TELL 
RE ST=TRANS(RE ST) /* ENSURE UPPERCASE */ 

3 ■ DO 1=1 TO WCGUNT (REST) /* FOR EACH WORD IN REST . - 

PARSE VAR REST NICKNAME REST /* GET 1S1 TOKEN INTO NIC 
18''- STATE NICKNAME DISTRIEs «** 

^ IF RC=0 THEN DO 

SAY NICKNAME 'IS A DISTRIBUTION LIST* 

ITERATE I 

^ 22;'' END 

/* NOT A LIST */ 

2- ? ; " SCANRMSG nickname 

^ IF RC=C> THEN /* SOME DATA WAS STACKED */ DO 

PULL NN NODE UID VIA NI N2 N3 N4 N5 
IF UID='*' THEN 

^ - SAY NICKNAME 'IS THE NICKNAME FOR THE LOCAL USER* VIA 

ELSE . 

SAY NICKNAME 'IS THE NICKNAME FOR' Nl M2 '('UID AT NODE') 
^ ITERATE I 

32 END 

/* NOTHING WAS STACKED, MIGHT BE A LOCAL USERID */ 

^ CPS TRANSFER CL 1 FROM NICKNAME 

PULL; PULL /* CLEAN STACK AFTER CPS */ 

IF RC=0 THEN SAY NICKNAME 'IS A LOCAL VM ID' 

ELSE SAY NICKNAME 'IS AN UNKNOWN NAME* 

END /* I */ 

EXIT 


TELL: 

SAY 

SAY 


/* TELL ABOUT THE PROGRAM */ 

CORRECT FORM: ADDR NaMEI <NAME2 <NAME3 ....»• 


say »addr Searches your rmsg file for the specified nickname.* 

SAY 'IF it FINDS Ti4e NAME, IT OISPLAYS THE ACTUAL SYSTEM AND USERID* 

ca Y ! Q r C I He UStK * IF THE NAME 15 N0T fdu ND, IT CHECKS FOR A LOCAL' 
SAY 'USERID WITH THE SAME NAME. • LOCAL 
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r 

ro. 

4 


S END EXEC ( FKtiM Id£ ££L£. i. nOCUHEM lAXIfl^> : 


/* CHECK NUMBER OF ARGUMENTS */ 


/* SEND FILE in A LOCAL USER 
ARGS ENAME NAME FN FT FM Z 
IF NAMES'* I NAMES'?* THEN DO 

SAY 'COMMAND IS: SEND USER FILENAME F1LETYPE <FILEMODE> • 
EXIT 100; END 
IF FT =" I Z-. = ' ' THEN DO 
SAY 'BAD SEND COMMAND* 

EXIT 101; END 

iF fm _ii T h6 N FM='*' /* ASSUME ANY IF NO MODE GIVEN */ 

CP SPOOL PUN NAME CLASS A 

IF RC->=C THEN DO /* CHECK SPOOL WORKED */ 

SAY NAME 'IS NOT A VALID USERID' 

EXIT 102? END 
PUNCH FN FT FM 

IF RC-’sO THEN DO /* CHECK PUNCH WORKED / 

SAY 'ERROR' RC 'FROM "PUNCH" (WHILE IN SeNO ) • 

NN=102 

END 

ELSE /* TELL RECIPIF.NT WHAT HAS BEEN DONE */ 

CP MSG NAME 'I HAVE JUST PUnCHEO YOU MY FILE* FN FT FM 
CP SPOOL PUN •*' CLASS A 
EXIT NN 
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c uRm £121IM — £im: ££iI ^ AR£ iHCWH ^ U ^ a 

/- *sx equivalent OF CUNC XEDIT (EXEC 2) macro */ 

CHECK ThE operands */ 

SELECT 

WHEN NUM =•I; D 0 
NUM =1; F1LL=* • 

END 

WHEN FILL=»'; do 

IF NUM= *? ' THEN DO 

/* CONC ? */ , 

MSG • +- - 

MSG 'I CORRECT FORM IS: CONC <N <FILL» [I 

MSG 


MSG 

MSG 'CONCATENATE THE NEXT N LINES USING FILL STRING A 
MSG 'SEPARATOR. DEFAULTS ARE I LINE AND SINGLE BLANK FILL 
MSG 'IF FILL=* THE LINES ARE' TO BE CONCATENATED WITHOUT 
MSG 'ANY SEPARATORS.' 

EXIT; END 
FILL=' * 

END 

OTHERWISE 

IF FILL='* * THEN FILL = ' ' 

END /* SELECT */ 


IF DATATYPE (NU?-i)-.= »NUM* THEN DO 
EMSG INVALID LINE COUNT "||NUM||" 

SIGNAL DISASTER; END 

/* NOW CHECK IF THE CONCATENATED LINE WILL FIT IN THE FILE */ 
TRANSFER LENGTH TRUNC LINE 
PULL L TRUNC FLINE 
IF L>255 THEN DO 

EMSG 'FILE TOO WIDE TO USE THIS MACRO* 

EXIT; END 
STACK 1 1 L 
PULL CURLINE 
STRING=CURLINE 
DO NUM 
NEXT 

IF RC-t=C THEN DO ' 

otto E 2l F INE EACHE0 BEF0RE C0N “™ATING. NUM .LINES,. 

SIGNAL DISASTER; END 
TRANSFER LENGTH 
PULL LEN 
STACK 1 1 LEN 
PULL CURLINE 
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STRING=STRING II FILL II CURLINE 
I =LE.NGTH( SIRING) 

"eiU^CCNMttWTEi) LINS LENGTH. I ’LXCEEDS TRUNC COLUNN. TRUNC 
GOTO FL1NE . ■ 

SIGNAL DISASTER', END 
END; /* NUM */ 

/* PUT THE CONCATENATED LINE IN THE FILE */ 

GOTO FLINE 
REPLACE STRING . 

NEXT 

DELETE NUM 

UP 

EXIT 

DISASTER: 

ARGS PROMPT 
REPLY PROMPT 


• 

o 

p 

o 

I 
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, MnA R0 «CMb) EXec 

LA ™L™ S m IR v TI0N F0R REX HAS MAINLY COME FROM the STAJ TH IS. MA NY 
S ^ MANY OF THE FEATURES FOLLOW DIRECTLY ON %EXAMFLt t HE 
LANGUAGES HAVE INFLUENCED TtiF DEVELOPMENT OF REX " n c THE NOTATION; 
hSS^ N 2 DL C0NST,<UCIS are very pl/i like, as is much ^catenates AMO 

HOW-VER THt CONCEPT OF Tut THE 'BLANK* OPERATOR WHICH NOT ), 

INSERTS A BLANK IS I BbLIrrVE ORIGINAL (PLEASE TELL ME •* r 


TOWN bVC PACKAGE 

exec 2 (BY C. j.STEPHENSON) , TOGETHER WITH THE YORK' C UL AKL Y IN THE 
(m.h.hack), have strongly influenced the language: paki instruction 
area OF host DEPENDENCIES and INTERFACES. THE "ADDRE-> thE EX£( . 
SYSTEM' INTtRFACE, FOR EXAMPLE, IS SIMILAR IN EFFECT 
"&PRESUME" STATEMENT. 


_ M . nf : CONSTRUCTIVE 

. VERY MANY (AT LEAST TWO HUNDRED) PEOPLE HAVE MAUL pniuTK IBUTFn 
CRITICISMS AND COMMENTS ON THt REX LANGUAGE; AND MANY HAVE ^ 

CODE AND DOCUMENTATION. MEMBERS OF THE RtX LANGUAGE 
ESPECIALLY HAVE BEEN OF CONSIDERABLE HELP IN THE DECISIONS le iu 

RELEASE 2.Cl OF ThE REX PACKAGE. 


THERE ARE NOW FAR TOO MANY TO GIVE THE INDIVIDUAL THANKS I WOULD 
LIKE TO HAVE INCLUDED IN TnIS DOCUMENT, BUT A.LL. REX USERS ARE INDEBTED 
TO THOSE PEOPLE FROM ALL OVER THE COMPANY WHO HAVE CONTRIBUTED HELP, 
SUGGESTIONS, AND TIME. 


MFC. 17TH AUGUST 198>. 
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APPENDIX: Id£ iiifiC.OMA£ia £ 


A SUBCOMMAND.. ENVIRONMENT USUALLY CORRESPONDS TO AN 
ENVIRONMENT, l.E. an environment IN WHICH A USER MAY enter 1; HACT1VE 
BE EXECUTED IN THAT ENVIRONMENT. AN EXAMPLE IS AN EDITOR, u h ,? HAN0S 10 
COMMANDS TO CHANGE, INSERT DR DELETE DATA IN A FILE, OR TO r ACCEPTS 
CURRENT LOCATION IN A FILE. TO DISTINGUISH COMMANDS 1 cc,,^ fS ' GE 1HE 
PARTICULAR ENVIRONMENT (SUCH AS AN EDITOR) FROM COMMANDS ISSHPn!, T ° A 
TO THE HOST (CMS), THE WORD 'SUBCOMMAND' IS USED. U DIRECTLY. 


PARTICULAR 

they, enquire 


IT r I ITM/-T ll,c ' C'MWUXKC 

(b.G. LfcNGTH OF THF fiiPRFNT 
INFORMATION SUPPUeVbY tS 


INTERACTIVE USERS REACT TO THE SUCCESS OR FAILURE OF 
SUBCOMMAND BY ADAPTING AN INTENDED SEQUENCE UF COMMANDS. 

ABOUT SPECIFIC ATTRIBUTES OF THE ENVIRONMENT ' 

LINfc) AND BASE SUBSEQUENT SUBCOMMANDS ON THE 
ENVIRONMENT (E.G. DISPLAYED IN A MESSAGE ARE. 

THE SUBCOM MECHANISM MAKES THIS MODE OF INTERACTION AVafi/u, - -rn 
PROGRAMS AS WELL AS HUMAN USERS. IT GIVES PROGRAMS ThE ABILITY Tn rcc.c 
SUBCOMMANDS TO THE ENVIRONMENT, TO REACT TO THE OUTCOME OF A SiiftrnMM 
AND TO RETRIEVE INFORMATION ABOUT THE ENVIRONMENT FOR SUBSEQUENT USE' 

TO USE THE SUBCOM MECHANISM, AN INTERACTIVE PROGRAM OFfi a 

SUBCOMMAND ENVIRONMENT. THIS INVOLVES DECLARING THE NAMF tip tup 
ENVIRONMENT, AND THE ENTRY POINT IN THE INTERACTIVE PROGRAM Taat 
PREPARED TO HANDLE SUBCOMMANDS ISSUED FROM OTHER PROGRAMS Tn tmp 

declared environment. b TQ ™ b 

PROGRAMS WHICH ISSUE SUBCOMMANDS TO INTERACTIVE ENVIRONMENTS APE 
OFTEN WRITTEN IN A CONVENIENT INTERPRETIVE LANGUAGE (SUCH AS EXEC 2 OR 
REX), AND ARE TRADITIONALLY CALLED MACROS. BOTH REX AND EXEC 2 HAVE THE 
CONVENTION THAT, UNLESS INSTRUCTED OTHERWISE, THEY DIRECT CCMMA^S TO A 
SUBCOMMAND ENVIRONMENT WHOSE NAME IS THE ElLETYPE Jf Jhe macJo! 
oSk NALLY ’ EDITORS DECLARE THEIR SUBCOMMAND ENVIRONMENT UND-R THEiR 

OWN^NAMb, and CLAIM THAT NAME AS THE FILETYPETO BE USED FOR S 

AT the IJJ MP 0F , J I2^iv UI y^«i T0R ( ' NEW CMS EDrT0R * 0F vm/sp, announced 

£L„Tr i AS ,, TMr^rs??2 pSS“^o?rs«:S, A I , s 2is ,, ;s?T! w " o,,M “ T - named 

ZONE) HE THE RU ED1T0R S 'RFFMFC* , ' JDS 1° fHE EDITUR < E *G. NEXT A, OR TRANSFER 

So^sr^ fr sr IS s *™°' 

RETRIEVING STACKED INF0RMATIOm IT t^ • BY rt ST TNG THE RETURN CODE AND 
APPROPRIATELY, AND THE FULL FLF XT ftn'i'r” AC R ° HAS THE A6ILITY tIL REACT 
AVAILABLE. ULL FLEXIb il-1TY OF A PROGRAMMABLE INTERFACE IS 

SUBCOMMAND L °ENVlRONMENTS UL OK EN rMP° NME:NT T0 BE ALTERED (BETWEEN VARIOUS 
NTS °* fHt HOST EVIRONMENT) USING THE ADDRESS 
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statement. s 

STATEMENT. EXEC 2 HAS A SIMILAR MECHANISM IN THE AP RtSUM c.iRfllMM*. 

nC £L 5UBLUMM A!\|0 p 

ft 

THE SUBCOM COMMAND IS USED TO DECLARE QUERY, uR 

ENVIRONMENTS. ’ 

$ 10| 

.f THAT IT CAinj P 

ONLY THE QUERY FORM OF SUBCOM IS A COMMAND, IN THE fORM OF This 

BE ISSUED FROM THE TERMINAL (OR FROM AN EXEC FILE). TH 

COMMAND IS: • ^ 

It 

SUBCOM NAME 


THIS YIELDS A RETURN CODE OF C IF *NaME• IS CURRENT 1 * DeFIN:D, OR 1 f) 

IF IT IS NOT DEFINED AS A SUBCOMMAND ENVIRONMENT NAME. 

O 

2C 

a R ? GR od S MAY CALL ™- SUBCOM FUNCTION WITH AN APPR0PR lA | p JO O 

n CANCEL AN ENVIRONMENT, OR TO OBTAIN COMPLETE * ° N 

O ' 

(A .FUNCTION. TAKES ^ FAR AMET ER^'l I ST IhICH^TaY CONTAIN BINARY O 

INFORMATION, SUCH AS FLAGS OR BINARY ADDRESSES, AND b THu S 

o 


r> ••• 

the COMMAND SUBMAP CAN BE USED TO LIST CURRENTLY DEFINED -SUBCOMMAND 

ENVIRONMENTS. ' O 

O J.: 

(FROM SUBCOM MEMO BY MICHEL HACK, YORKTQWN HEIGHTS, FEBRUARY 1V8C) 

O ■ 

O 

36 

o 

p 

o 

■ c 
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